RpcBindingFree function
Applies to: desktop apps only
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
| Value | Meaning |
|---|---|
|
The call succeeded. |
|
The binding handle was invalid. |
|
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:
- RpcBindingCopy
- RpcBindingFromStringBinding
- RpcBindingServerFromClient
- RpcServerInqBindings
- RpcNsBindingImportNext
- RpcNsBindingSelect
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 |
|---|---|
|
Minimum supported server | Windows 2000 Server |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- RpcBindingCopy
- RpcBindingFromStringBinding
- RpcBindingVectorFree
- RpcNsBindingImportNext
- RpcNsBindingLookupNext
- RpcNsBindingSelect
- RpcServerInqBindings
Send comments about this topic to Microsoft
Build date: 3/6/2012
