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)