RpcServerRegisterIf 関数 (rpcdce.h)

[アーティクル]
08/25/2023

RpcServerRegisterIf 関数は、RPC ランタイムライブラリにインターフェイスを登録します。

構文

RPC_STATUS RpcServerRegisterIf(
  RPC_IF_HANDLE IfSpec,
  UUID          *MgrTypeUuid,
  RPC_MGR_EPV   *MgrEpv
);

パラメーター

IfSpec

登録するインターフェイスを示す MIDL で生成された構造体。

MgrTypeUuid

MgrEpv パラメーターに関連付ける UUID 型へのポインター。 null パラメーター値 (または nil UUID) を指定すると、 IfSpec が nil 型 UUID に登録されます。

MgrEpv

マネージャールーチンのエントリポイントベクター (EPV)。 MIDL で生成された既定の EPV を使用するには、null 値を指定します。詳細については、「 RPC_MGR_EPV」を参照してください。

戻り値

成功時にRPC_S_OKを返します。

メモ有効なエラーコードの一覧については、「 RPC 戻り値」を参照してください。

注釈

サーバーは、RPC ランタイムライブラリに無制限の数のインターフェイスを登録できます。登録により、サーバーへのバインドハンドルを使用して、クライアントがインターフェイスを使用できるようになります。インターフェイスを登録するために、サーバーアプリケーションコードは RpcServerRegisterIf を呼び出します。サーバーが提供するインターフェイスの実装ごとに、個別のマネージャー EPV を登録する必要があります。

RpcServerRegisterIf を呼び出すと、サーバーは次の情報を提供します。

インターフェイスの仕様
インターフェイス仕様は、MIDL コンパイラによって生成されるデータ構造です。サーバーは 、IfSpec パラメーターを使用してインターフェイスを指定します。
マネージャーの種類 UUID とマネージャー EPV
マネージャーの種類は UUID で、マネージャー EPV は、サーバーがクライアントからリモートプロシージャコール要求を受信したときに実行されるマネージャールーチンを決定します。

サーバーは、 MgrTypeUuid パラメーターと MgrEpv パラメーターを使用して、マネージャーの種類 UUID と EPV を指定します。 nil 以外のマネージャー型 UUID を指定する場合、サーバーは RpcObjectSetType 関数も呼び出して、この nil 以外の型のオブジェクトを登録する必要があることに注意してください。

サーバーアプリケーションで自動リッスンインターフェイスを登録する必要がある場合、または認証のためにコールバック関数を使用する必要がある場合は、 RpcServerRegisterIfEx を使用します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	rpcdce.h (Rpc.h を含む)
Library	Rpcrt4.lib
[DLL]	Rpcrt4.dll