NAME

rpc_string_binding_parse — Returns, as separate strings, the components of a string binding;  used by client or server applications

Synopsis

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

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

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

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_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).