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) |
程式庫 | Rpcrt4.lib |
Dll | Rpcrt4.dll |