rpcServerInqBindings 函数 (rpcdce.h)

项目
03/01/2024

RpcServerInqBindings 函数返回可接收远程过程调用的绑定句柄。

语法

RPC_STATUS RpcServerInqBindings(
  RPC_BINDING_VECTOR **BindingVector
);

参数

BindingVector

返回指向指向服务器绑定句柄矢量的指针的指针。

返回值

值	含义
RPC_S_OK	调用成功。
RPC_S_NO_BINDINGS	没有绑定。

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

注解

服务器应用程序调用 RpcServerInqBindings 以获取服务器绑定句柄的向量。当服务器应用程序调用以下函数来注册协议序列时，RPC 运行时库会创建绑定句柄：

返回的绑定向量可以包含具有动态终结点的绑定句柄或具有已知终结点的绑定句柄，具体取决于服务器应用程序调用的上述哪个函数。

服务器使用绑定句柄向量导出到名称服务、在本地终结点映射数据库中注册或转换为字符串绑定。如果没有绑定句柄 (没有注册的协议序列) ，此例程将返回RPC_S_NO_BINDINGS状态代码和 BindingVector 参数值 NULL。服务器负责调用 RpcBindingVectorFree 函数以释放矢量使用的内存。

要求

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