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)