rpcServerInterfaceGroupActivate 函数 (rpcdce.h)
RpcServerInterfaceGroupActivate 函数告知 RPC 服务器运行时注册接口组的接口和终结点,并开始侦听调用。
语法
RPC_STATUS RpcServerInterfaceGroupActivate(
[in] RPC_INTERFACE_GROUP IfGroup
);
参数
[in] IfGroup
来自 RpcServerInterfaceGroupCreate 的RPC_INTERFACE_GROUP,用于定义要激活的接口组。
返回值
值 | 含义 |
---|---|
|
调用成功。 |
|
此主机上不支持协议序列。 |
|
协议序列无效。 |
|
终结点格式无效。 |
|
系统内存不足。 |
|
终结点或接口的安全描述符无效。 |
注意 有关有效错误代码的列表,请参阅 RPC 返回值。
注解
RpcServerInterfaceGroupActivate 执行 RPC 服务器应用程序需要执行的大部分初始化工作。 它执行以下操作:
- 指示 RPC 运行时开始侦听调用。
- 将终结点注册到服务器运行时。
- 向服务器运行时注册接口。
- 向 RPC 终结点映射器注册终结点和接口。
RpcServerInterfaceGroupActivate 是原子性的。 如果操作在任意时间点失败,则会撤消以前注册的任何项。
在此函数返回之前,可能会将调用调度到服务器应用程序。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | Windows |
标头 | rpcdce.h (包括 Rpc.h) |
Library | Rpcrt4.lib |
DLL | Rpcrt4.dll |