RpcBindingToStringBinding function (rpcdce.h)

The RpcBindingToStringBinding function returns a string representation of a binding handle.

Syntax

RPC_STATUS RpcBindingToStringBinding(
  RPC_BINDING_HANDLE Binding,
  RPC_CSTR           *StringBinding
);

Parameters

Binding

Client or server binding handle to convert to a string representation of a binding handle.

StringBinding

Returns a pointer to a pointer to the string representation of the binding handle specified in the Binding parameter.

Specify a null value to prevent RpcBindingToStringBinding from returning the StringBinding parameter. In this case, the application does not call the RpcStringFree function.

Return value

Remarks

The RpcBindingToStringBinding function converts a client or server binding handle to its string representation.

The RPC run-time library allocates memory for the string returned in the StringBinding parameter. The application is responsible for calling the RpcStringFree function to deallocate that memory.

If the binding handle in the Binding parameter contained a nil object UUID, the object UUID field is not included in the returned string.

To parse the returned StringBinding parameter, call the RpcStringBindingParse function.

Requirements

See also

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree