NAME

rpc_string_binding_compose — Combines the components of a string binding into a string binding;  used by client or server applications

Synopsis

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_uuidSpecifies a NULL-terminated string representation of an object UUID. 

protseqSpecifies a NULL-terminated string representation of a protocol sequence. 

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

endpointSpecifies a NULL-terminated string representation of an endpoint. 

optionsSpecifies 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(). 

statusReturns 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 ( ) 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).