Export (0) Print
Expand All
Expand Minimize

RpcBindingFree function

The RpcBindingFree function releases binding-handle resources.

Syntax


RPC_STATUS RPC_ENTRY RpcBindingFree(
  RPC_BINDING_HANDLE *Binding
);

Parameters

Binding

Pointer to the server binding to be freed.

Return value

ValueMeaning
RPC_S_OK

The call succeeded.

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

The RpcBindingFree function releases memory used by a server binding handle. Referenced binding information that was dynamically created during program execution is released as well. An application calls the RpcBindingFree function when it is finished using the binding handle. RPC binding handles must not be freed until all calls using the handle have completed; failure to do so will cause unpredictable results.

Binding handles are dynamically created by calling the following functions:

If the operation successfully frees the binding, the Binding parameter returns a value of NULL.

Note  Microsoft RPC supports RpcBindingFree only in client applications, or in server applications for binding handles generated with RpcBindingServerFromClient.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Rpcdce.h (include Rpc.h)

Library

Rpcrt4.lib

DLL

Rpcrt4.dll

See also

RpcBindingCopy
RpcBindingFromStringBinding
RpcBindingVectorFree
RpcNsBindingImportNext
RpcNsBindingLookupNext
RpcNsBindingSelect
RpcServerInqBindings

 

 

Community Additions

ADD
Show:
© 2014 Microsoft