RpcServerInterfaceGroupInqBindings 函数 (rpcdce.h)

  • 项目

RpcServerInterfaceGroupInqBindings 函数返回绑定句柄，可通过该句柄接收给定接口组的远程过程调用。

语法

RPC_STATUS RpcServerInterfaceGroupInqBindings(
  [in]  RPC_INTERFACE_GROUP IfGroup,
  [out] RPC_BINDING_VECTOR  **BindingVector
);

参数

[in] IfGroup

RpcServerInterfaceGroupCreate 中的RPC_INTERFACE_GROUP，用于定义应查询绑定的接口组。

[out] BindingVector

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

返回值

值 含义
RPC_S_OK
 调用成功。
RPC_S_NO_BINDINGS
 没有绑定。
 
注意 有关有效错误代码的列表，请参阅 RPC 返回值。
 

注解

服务器应用程序调用 RpcServerInterfaceGroupInqBindings 以获取给定接口组的服务器绑定句柄的向量。 当服务器应用程序调用 RpcServerInterfaceGroupActivate 函数时，RPC 运行时库为接口组创建绑定句柄。

返回的绑定向量可以包含具有动态终结点的绑定句柄或具有已知终结点的绑定句柄，具体取决于接口组的终结点规范。

服务器使用绑定句柄的向量导出到名称服务或转换为字符串绑定。 如果没有绑定句柄 (没有注册的协议序列 ) ，RpcServerInterfaceGroupInqBindings 将返回 RPC_S_NO_BINDINGS 并且 BindingVector 为 NULL。 服务器负责调用 RpcBindingVectorFree 以释放向量的内存。

要求

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

另请参阅

RpcServerInterfaceGroupActivate

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate