Share via

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