| ## rpc_string_binding_parse(3rpc) Returns, as separate strings, the components of a string binding Used by client or server applications. Synopsis #include <dce/rpc.h> void rpc_string_binding_parse( unsigned_char_t *string_binding, unsigned_char_t **obj_uuid, unsigned_char_t **protseq, unsigned_char_t **network_addr, unsigned_char_t **endpoint, unsigned_char_t **network_options, unsigned32 *status); Parameters Input string_binding Specifies a NULL-terminated string representation of a binding. Output obj_uuid Returns a pointer to a NULL-terminated string representation of an object UUID. Specify NULL to prevent the routine from returning this parameter. In this case the application does not call rpc_string_free( ). protseq Returns a pointer to a NULL-terminated string representation of a protocol sequence. Specify NULL to prevent the routine from returning this parameter. In this case the application does not call rpc_string_free( ). network_addr Returns a pointer to a NULL-terminated string representation of a network address. Specify NULL to prevent the routine from returning this parameter. In this case the application does not call rpc_string_free( ). endpoint Returns a pointer to a NULL-terminated string representation of an endpoint. Specify NULL to prevent the routine from returning this parameter. In this case the application does not call rpc_string_free( ). network_options Returns a pointer to a NULL-terminated string representation of network options. Specify NULL to prevent the routine from returning this parameter. 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_parse( ) routine parses a string representation of a binding handle into its component fields. The RPC runtime allocates memory for each component string the routine returns. The application calls rpc_string_free( ) once for each returned string to deallocate the memory for that string. If any field of the string_binding field is empty, rpc_string_binding_parse( ) returns the empty string in the corresponding output parameter. 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. rpc_s_invalid_string_binding Invalid string binding. Related Information Functions: rpc_binding_from_string_binding(3rpc) rpc_binding_to_string_binding(3rpc) rpc_string_binding_compose(3rpc) rpc_string_free(3rpc) uuid_from_string(3rpc) ##