rpcBindingFree 函数 (rpcdce.h)

RpcBindingFree 函数释放绑定句柄资源。

语法

RPC_STATUS RpcBindingFree(
  RPC_BINDING_HANDLE *Binding
);

parameters

Binding

指向要释放的服务器绑定的指针。

返回值

含义
RPC_S_OK
调用成功。
RPC_S_INVALID_BINDING
绑定句柄无效。
RPC_S_WRONG_KIND_OF_BINDING
这是操作的错误绑定类型。
 
注意 有关有效错误代码的列表,请参阅 RPC 返回值
 

注解

RpcBindingFree 函数释放服务器绑定句柄使用的内存。 此外,还会释放在程序执行期间动态创建的引用绑定信息。 应用程序在使用绑定句柄完成时调用 RpcBindingFree 函数。 在使用该句柄的所有调用完成之前,不得释放 RPC 绑定句柄;否则将导致不可预知的结果。

绑定句柄是通过调用以下函数动态创建的:

如果操作成功释放绑定, 则 Binding 参数将返回 NULL 值。
注意Microsoft RPC 仅支持在客户端应用程序或服务器应用程序中使用 RpcBindingServerFromClient 生成的绑定句柄使用 RpcBindingFree。
 

要求

   
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 rpcdce.h (包括 Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

请参阅

RpcBindingCopy

RpcBindingFromStringBinding

RpcBindingVectorFree

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcServerInqBindings