RpcServerInterfaceGroupActivate 関数 (rpcdce.h)

RpcServerInterfaceGroupActivate 関数は、インターフェイス グループのインターフェイスとエンドポイントを登録し、呼び出しのリッスンを開始するように RPC サーバー ランタイムに指示します。

構文

RPC_STATUS RpcServerInterfaceGroupActivate(
  [in] RPC_INTERFACE_GROUP IfGroup
);

パラメーター

[in] IfGroup

アクティブ化するインターフェイス グループを定義する RpcServerInterfaceGroupCreate からのRPC_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