rpcBindingServerFromClient 函数 (rpcdce.h)

项目
08/25/2023

应用程序调用 RpcBindingServerFromClient 将客户端绑定句柄转换为部分绑定的服务器绑定句柄。

语法

RPC_STATUS RpcBindingServerFromClient(
  RPC_BINDING_HANDLE ClientBinding,
  RPC_BINDING_HANDLE *ServerBinding
);

parameters

ClientBinding

要转换为服务器绑定句柄的客户端绑定句柄。如果指定了零值，则服务器将模拟由此服务器线程提供服务的客户端。

注意此参数在 Windows NT 4.0 中不能为 NULL 。

ServerBinding

返回服务器绑定句柄。

返回值

值	含义
RPC_S_OK	调用成功。
RPC_S_INVALID_BINDING	绑定句柄无效。
RPC_S_WRONG_KIND_OF_BINDING	这是操作的错误绑定类型。
RPC_S_CANNOT_SUPPORT	无法确定客户端的主机。有关支持的协议序列列表，请参阅备注。

注意有关有效错误代码的列表，请参阅 RPC 返回值。

注解

以下协议序列支持 RpcBindingServerFromClient：

ncadg_ip_udp
ncadg_ipx
ncacn_ip_tcp
ncacn_spx。
windows 2000) ncacn_np (生效
ncacn_http
ncalrpc

应用程序从 RPC 运行时获取客户端绑定句柄。当远程过程调用到达服务器时，运行时会创建一个客户端绑定句柄，其中包含有关调用客户端的信息。运行时将此句柄作为第一个参数传递给服务器管理器函数。

调用 RpcBindingServerFromClient 会将此客户端句柄转换为具有以下属性的服务器句柄：

服务器句柄是部分绑定的句柄。它包含调用客户端的网络地址，但缺少终结点。
服务器句柄包含调用客户端使用的同一对象 UUID 。这可以是 nil UUID。有关客户端如何为调用指定对象 UUID 的详细信息，请参阅 RpcBindingsetObject、 RpcNsBindingImportBegin、 RpcNsBindingLookupBegin 和 RpcBindingFromStringBinding。
服务器句柄不包含身份验证信息。

服务器应用程序必须调用 RpcBindingFree ，以释放服务器绑定句柄不再需要的资源。

注意若要查询客户端的地址，应用程序首先调用 RpcBindingServerFromClient 函数以获取部分绑定的服务器绑定句柄。服务器绑定句柄可用于通过调用 RpcBindingToStringBinding 来获取字符串绑定。然后，服务器可以调用 RpcStringBindingParse，以从字符串绑定中提取客户端的网络地址。

要求


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