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
);
Specify a null value to prevent RpcStringBindingParse from returning the ObjectUuid argument. In this case, the application does not call the RpcStringFree routine.
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.
Specify a null value to prevent RpcStringBindingParse from returning the NetworkAddr argument. In this case, the application does not call the RpcStringFree routine.
Specify a null value to prevent RpcStringBindingParse from returning the EndPoint argument. In this case, the application does not call the RpcStringFree routine.
Specify a null value to prevent RpcStringBindingParse from returning the NetworkOptions argument. In this case, the application does not call the RpcStringFree routine.
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.
Value | Meaning |
---|---|
RPC_S_OK | Success |
RPC_S_INVALID_STRING_BINDING | Invalid string binding |
Windows NT: Yes
Windows CE: Unsupported.
Header: Declared in rpcdce.h.
Import Library: Link with rpcrt4.lib.
RpcBindingFromStringBinding, RpcBindingToStringBinding, RpcStringBindingCompose, RpcStringFree