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 |
See Also