RpcBindingFree  1SBCOC

The RpcBindingFree function releases binding-handle resources.

#include <rpc.h>

RPC_STATUS RPC_ENTRY RpcBindingFree(

    RPC_BINDING_HANDLE *  Binding

 

   );

 

 

Parameters

Binding

Points to the server binding to free.

 

Remarks

 

Note  Microsoft RPC supports RpcBindingFree only in client applications, not in server applications.

 

The RpcBindingFree routine 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 routine when it is finished using the binding handle.

Binding handles are dynamically created by calling the following routines:

    RpcBindingCopy

    RpcBindingFromStringBinding

    RpcServerInqBindings

    RpcNsBindingImportNext

    RpcNsBindingSelect

 

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

Return Values

Value

Meaning

RPC_S_OK

Success

RPC_S_INVALID_BINDING

Invalid binding handle

RPC_S_WRONG_KIND_OF_BINDING

Wrong kind of binding for operation

 

See Also

RpcBindingCopy, RpcBindingFromStringBinding, RpcBindingVectorFree, RpcNsBindingImportNext, RpcNsBindingLookupNext, RpcNsBindingSelect, RpcServerInqBindings