PreviousNext

rpc_string_binding_compose(3rpc)

Combines the components of a string binding into a string binding

Used by client or server applications.

Synopsis

#include <dce/rpc.h>

void rpc_string_binding_compose(

unsigned_char_t *obj_uuid,

unsigned_char_t *protseq,

unsigned_char_t *network_addr,

unsigned_char_t *endpoint,

unsigned_char_t *options,

unsigned_char_t **string_binding,

unsigned32 *status);

Parameters

Input

obj_uuid
Specifies a NULL-terminated string representation of an object UUID.

protseq
Specifies a NULL-terminated string representation of a protocol sequence.

network_addr
Specifies a NULL-terminated string representation of a network address.

endpoint
Specifies a NULL-terminated string representation of an endpoint.

options
Specifies a NULL-terminated string representation of network options.

Output

string_binding
Returns a pointer to a NULL-terminated string representation of a binding handle.

Specify NULL to prevent the routine from returning this argument. In this case the application does not call rpc_string_free( ).

status
Returns the status code from this routine. This status code indicates whether the routine completed successfully or, if not, why not.

Description
The rpc_string_binding_compose( ) routine combines string binding handle components into a string binding handle.

The RPC runtime allocates memory for the string returned in the string_binding parameter. The application calls rpc_string_free( ) to deallocate that memory.

Specify NULL or provide a null string (\0) for each input string that has no data.

Return Values
No value is returned.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

rpc_s_ok
Success.

Related Information
Functions: rpc_binding_from_string_binding(3rpc)

rpc_binding_to_string_binding(3rpc)

rpc_string_binding_parse(3rpc)

rpc_string_free(3rpc)

uuid_to_string(3rpc)