NAME

rpc_string_binding_parse - 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_bindingSpecifies 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 argument. In this case the application does not call the rpc_string_free routine. 

protseqReturns a pointer to a null-terminated string representation of a protocol sequence.  Specify NULL to prevent the routine from returning this argument. In this case the application does not call the rpc_string_free routine. 

network_addrReturns a pointer to a null-terminated string representation of a network address.  Specify NULL to prevent the routine from returning this argument. In this case the application does not call the rpc_string_free routine. 

endpointReturns a pointer to a null-terminated string representation of an endpoint.  Specify NULL to prevent the routine from returning this argument. In this case the application does not call the rpc_string_free routine. 

network_optionsReturns a pointer to a null-terminated string representation of network options.  Specify NULL to prevent the routine from returning this argument. In this case the application does not call the rpc_string_free routine. 

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not.  The possible status codes and their meanings are as follows:

rpc_s_okSuccess. 

rpc_s_invalid_string_binding
Invalid string binding.

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 the rpc_string_free routine once for each returned string to deallocate the memory for that string. 

If any field of the string_binding is empty, the rpc_string_binding_parse routine returns the empty string in the corresponding output argument. 

RETURN VALUES

None. 

RELATED INFORMATION

Functions: rpc_binding_from_string_binding(3), rpc_binding_to_string_binding(3), rpc_string_binding_compose(3), rpc_string_free(3), uuid_from_string(3)