rpcBindingCopy 函数 (rpcdce.h)

RpcBindingCopy 函数复制绑定信息并创建新的绑定句柄。

语法

RPC_STATUS RpcBindingCopy(
  RPC_BINDING_HANDLE SourceBinding,
  RPC_BINDING_HANDLE *DestinationBinding
);

参数

SourceBinding

复制引用的绑定信息的服务器绑定句柄。

DestinationBinding

返回指向服务器绑定句柄的指针,该句柄引用复制的绑定信息。

返回值

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

注解

RpcBindingCopy 函数复制 SourceBinding 参数引用的服务器绑定信息。 RpcBindingCopy 使用 DestinationBinding 参数返回复制的绑定信息的新服务器绑定句柄。 RpcBindingCopy 还会将身份验证信息从 SourceBinding 参数复制到 DestinationBinding 参数。

当应用程序想要阻止一个线程对绑定信息进行更改时,应用程序使用 RpcBindingCopy 来影响其他线程使用的绑定信息。

应用程序调用 RpcBindingCopy 后,对 SourceBinding 绑定句柄执行的操作不会影响 DestinationBinding 绑定句柄引用的绑定信息。 同样,对 DestinationBinding 绑定句柄执行的操作不会影响 SourceBinding 绑定句柄引用的绑定信息。

如果应用程序希望一个线程更改绑定信息,以影响其他线程使用的绑定信息,则应用程序应跨线程共享单个绑定句柄。 在这种情况下,应用程序负责绑定句柄并发控制。

当应用程序使用 DestinationBinding 参数指定的绑定句柄完成时,应用程序应调用 RpcBindingFree 函数来释放 DestinationBinding 绑定句柄及其引用的绑定信息所使用的内存。

注意 Microsoft RPC 仅在客户端应用程序(而不是服务器应用程序中)支持 RpcBindingCopy
 

要求

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

另请参阅

RpcBindingFree