RpcStringBindingParse

The RpcStringBindingParse function returns the object UUID part and the address parts of a string binding as separate strings.

#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcStringBindingParse( 
  unsigned char *  StringBinding,   
  unsigned char * *  ObjectUuid,   
  unsigned char * *  ProtSeq,    
  unsigned char * *  NetworkAddr,   
  unsigned char * *  EndPoint,   
  unsigned char * *  NetworkOptions  
);
 

Parameters

StringBinding
Points to a NULL-terminated string representation of a binding.
ObjectUuid
Returns a pointer to a pointer to a NULL-terminated string representation of an object UUID.

Specify a null value to prevent RpcStringBindingParse from returning the ObjectUuid argument. In this case, the application does not call the RpcStringFree routine.

ProtSeq
Returns a pointer to a pointer to a NULL-terminated string representation of a protocol sequence.

For a list of Microsoft RPC's supported protocol sequences, see the reference topic String Binding in RPC Data Types and Structures.

Specify a null value to prevent RpcStringBindingParse from returning the ProtSeq argument. In this case, the application does not call the RpcStringFree routine.

NetworkAddr
Returns a pointer to a pointer to a NULL-terminated string representation of a network address.

Specify a null value to prevent RpcStringBindingParse from returning the NetworkAddr argument. In this case, the application does not call the RpcStringFree routine.

EndPoint
Returns a pointer to a pointer to a NULL-terminated string representation of an endpoint.

Specify a null value to prevent RpcStringBindingParse from returning the EndPoint argument. In this case, the application does not call the RpcStringFree routine.

NetworkOptions
Returns a pointer to a pointer to a NULL-terminated string representation of network options.

Specify a null value to prevent RpcStringBindingParse from returning the NetworkOptions argument. In this case, the application does not call the RpcStringFree routine.

Remarks

An application calls the RpcStringBindingParse routine to parse a string representation of a binding handle into its component fields.

The RPC run-time library allocates memory for each component string returned. The application is responsible for calling the RpcStringFree routine once for each returned string to deallocate the memory for that string.

If any field of the StringBinding argument is empty, the RpcStringBindingParse routine returns an empty string ("\0") in the corresponding output argument.

Return Values

Value Meaning
RPC_S_OK Success
RPC_S_INVALID_STRING_BINDING Invalid string binding

QuickInfo

  Windows NT: Yes
  Windows CE: Unsupported.
  Header: Declared in rpcdce.h.
  Import Library: Link with rpcrt4.lib.

See Also

RpcBindingFromStringBinding, RpcBindingToStringBinding, RpcStringBindingCompose, RpcStringFree