RpcStringBindingParse function

The RpcStringBindingParse function returns the object UUID part and the address parts of a string binding as separate strings. An application calls RpcStringBindingParse to parse a string representation of a binding handle into its component fields. The RpcStringBindingParse function returns the object UUID part and the address parts of a string binding as separate strings.

Syntax

RPC_STATUS RPC_ENTRY RpcStringBindingParse(
   TCHAR *StringBinding,
   TCHAR **ObjectUuid,
   TCHAR **ProtSeq,
   TCHAR **NetworkAddr,
   TCHAR **EndPoint,
   TCHAR **NetworkOptions
);

Parameters

StringBinding

Pointer 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 parameter. In this case, the application does not call RpcStringFree.

ProtSeq

Returns a pointer to a pointer to a null-terminated string representation of a protocol sequence. For a list of Microsoft RPC supported protocol sequences, see String Binding.

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

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 parameter. In this case, the application does not call RpcStringFree.

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 parameter. In this case, the application does not call RpcStringFree.

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 parameter. In this case, the application does not call RpcStringFree.

Return value

Remarks

An application calls 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 RpcStringFree once for each returned string to deallocate the memory for that string.

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

Requirements

See also

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree