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 |