rpcBindingFree 函数 (rpcdce.h)
RpcBindingFree 函数释放绑定句柄资源。
语法
RPC_STATUS RpcBindingFree(
RPC_BINDING_HANDLE *Binding
);
parameters
Binding
指向要释放的服务器绑定的指针。
返回值
值 | 含义 |
---|---|
|
调用成功。 |
|
绑定句柄无效。 |
|
这是操作的错误绑定类型。 |
注意 有关有效错误代码的列表,请参阅 RPC 返回值。
注解
RpcBindingFree 函数释放服务器绑定句柄使用的内存。 此外,还会释放在程序执行期间动态创建的引用绑定信息。 应用程序在使用绑定句柄完成时调用 RpcBindingFree 函数。 在使用该句柄的所有调用完成之前,不得释放 RPC 绑定句柄;否则将导致不可预知的结果。
绑定句柄是通过调用以下函数动态创建的:
- RpcBindingCopy
- RpcBindingFromStringBinding
- RpcBindingServerFromClient
- RpcServerInqBindings
- RpcNsBindingImportNext
- RpcNsBindingSelect
注意Microsoft RPC 仅支持在客户端应用程序或服务器应用程序中使用 RpcBindingServerFromClient 生成的绑定句柄使用 RpcBindingFree。
要求
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | rpcdce.h (包括 Rpc.h) |
Library | Rpcrt4.lib |
DLL | Rpcrt4.dll |