次の方法で共有


RpcServerRegisterIf 関数 (rpcdce.h)

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

こちらもご覧ください

インターフェイスの登録

RpcBindingFromStringBinding

RpcBindingSetObject

RpcNsBindingExport

RpcNsBindingImportBegin

RpcNsBindingLookupBegin

RpcObjectSetType

RpcServerRegisterIf2

RpcServerRegisterIf3

RpcServerRegisterIfEx

RpcServerUnregisterIf

RpcServerUnregisterIfEx