RpcBindingVectorFree function (rpcdce.h)

Article
02/22/2024

The RpcBindingVectorFree function frees the binding handles contained in the vector and the vector itself.

Syntax

RPC_STATUS RpcBindingVectorFree(
  RPC_BINDING_VECTOR **BindingVector
);

Parameters

BindingVector

Pointer to a pointer to a vector of server binding handles. On return, the pointer is set to NULL.

Return value

Value	Meaning
RPC_S_OK	The call succeeded.
RPC_S_INVALID_ARG	The argument was invalid.
RPC_S_INVALID_BINDING	The binding handle was invalid.
RPC_S_WRONG_KIND_OF_BINDING	This was the wrong kind of binding for the operation.

Note For a list of valid error codes, see RPC Return Values.

Remarks

An application calls the RpcBindingVectorFree function to release the memory used to store a vector of server binding handles. The function frees both the binding handles and the vector itself.

A server obtains a vector of binding handles by calling the RpcServerInqBindings function. A client obtains a vector of binding handles by calling the RpcNsBindingLookupNext function.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	rpcdce.h (include Rpc.h)
Library	Rpcrt4.lib
DLL	Rpcrt4.dll