rpcServerInterfaceGroupActivate 函数 (rpcdce.h)

RpcServerInterfaceGroupActivate 函数告知 RPC 服务器运行时注册接口组的接口和终结点,并开始侦听调用。

语法

RPC_STATUS RpcServerInterfaceGroupActivate(
  [in] RPC_INTERFACE_GROUP IfGroup
);

参数

[in] IfGroup

来自 RpcServerInterfaceGroupCreateRPC_INTERFACE_GROUP,用于定义要激活的接口组。

返回值

含义
RPC_S_OK
调用成功。
RPC_S_PROTSEQ_NOT_SUPPORTED
此主机上不支持协议序列。
RPC_S_INVALID_RPC_PROTSEQ
协议序列无效。
RPC_S_INVALID_ENDPOINT_FORMAT
终结点格式无效。
RPC_S_OUT_OF_MEMORY
系统内存不足。
RPC_S_INVALID_SECURITY_DESC
终结点或接口的安全描述符无效。
 
注意 有关有效错误代码的列表,请参阅 RPC 返回值
 

注解

RpcServerInterfaceGroupActivate 执行 RPC 服务器应用程序需要执行的大部分初始化工作。 它执行以下操作:

  • 指示 RPC 运行时开始侦听调用。
  • 将终结点注册到服务器运行时。
  • 向服务器运行时注册接口。
  • 向 RPC 终结点映射器注册终结点和接口。

RpcServerInterfaceGroupActivate 是原子性的。 如果操作在任意时间点失败,则会撤消以前注册的任何项。

在此函数返回之前,可能会将调用调度到服务器应用程序。

要求

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

另请参阅

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate

RpcServerInterfaceGroupInqBindings