RpcEpRegister 関数 (rpcdce.h)

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

RpcEpRegister 関数は、ローカルエンドポイントマップデータベースのサーバーアドレス情報に追加または置換します。

構文

RPC_STATUS RpcEpRegister(
  RPC_IF_HANDLE      IfSpec,
  RPC_BINDING_VECTOR *BindingVector,
  UUID_VECTOR        *UuidVector,
  RPC_CSTR           Annotation
);

パラメーター

IfSpec

ローカルエンドポイントマップデータベースに登録するためのインターフェイス。

BindingVector

サーバーがリモートプロシージャ呼び出しを受信できるバインディングハンドルのベクターへのポインター。

UuidVector

サーバーによって提供されるオブジェクト UUID のベクトルへのポインター。サーバーアプリケーションはこのベクトルを構築します。null 引数の値は、登録するオブジェクト UUID がないことを示します。

Annotation

ローカルエンドポイントマップデータベースに追加された各製品間要素に適用される文字列コメントへのポインター。文字列は、null 終端文字を含め、最大 64 文字の長さにできます。注釈文字列がない場合は、null 値または null で終わる文字列 ("\0") を指定します。

注釈文字列は、情報のみを目的としてアプリケーションによって使用されます。 RPC はこの文字列を使用して、クライアントが通信するサーバーインスタンスを特定したり、エンドポイントマップデータベース内の要素を列挙したりしません。

戻り値

値	意味
RPC_S_OK	呼び出しは成功しました。
RPC_S_NO_BINDINGS	バインドはありません。
RPC_S_INVALID_BINDING	バインドハンドルが無効でした。
RPC_S_WRONG_KIND_OF_BINDING	これは、操作の間違った種類のバインドでした。

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

注釈

RpcEpRegister 関数は、ローカルホストの endpoint-map データベースのエントリを追加または置換します。指定されたインターフェイス仕様、バインドハンドル、およびオブジェクト UUID に一致する既存のデータベースエントリの場合、この関数はエントリのエンドポイントを、指定されたバインドハンドル内のエンドポイントに置き換えます。

サーバーは RpcEpRegister と RpcEpRegisterNoReplace を使用して、エンドポイントマッパーデータベースにエントリを登録できます。 Windows 2000 より前のバージョンでは、実行されなくなった以前のサーバーインスタンスから残されたエンドポイントマッパーデータベース内の古いエントリをサーバーが上書きできるようにするための 2 つの関数を使用できます。エンドポイントマッパーデータベースは、サーバーが機能を停止するとすぐに、サーバーインスタンスによって登録されたエントリを自動的に削除します。ただし、サーバーは、セキュリティ上の目的で別のサーバーのエンドポイントマッパーエントリを置き換えることはできません。したがって、 RpcEpRegister と RpcEpRegisterNoReplace は、ほぼ同じ機能を実行します。

サーバーアプリケーションは RpcEpRegister を呼び出して、次のいずれかの関数を呼び出して指定されたエンドポイントを登録します。

サーバーもネームサービスデータベースにエクスポートする場合、サーバーは RpcNsBindingExport 関数を呼び出すときに使用されるのと同じ IfSpec、BindingVector、UuidVector 値を使用して RpcEpRegister を呼び出します。

エンドポイントを指定せずにプロトコルシーケンスを使用すると、RPC ランタイムライブラリによって動的エンドポイントが自動的に生成されます。この場合、サーバーは RpcServerInqBindings を呼び出し、その後 に RpcEpRegister を呼び出して、それ自体を複数のクライアントで使用できるようにします。それ以外の場合、自動的に開始されたサーバーは、サーバーが開始されたクライアントにのみ認識されます。エンドポイントマップデータベースに追加された各要素には、次のものが論理的に含まれています。

インターフェイス UUID
インターフェイスのバージョン (メジャーとマイナー)
バインドハンドル
オブジェクト UUID (省略可能)
注釈 (省略可能)

RpcEpRegister は 、IfSpec、 BindingVector、 UuidVector パラメーターからクロス積を作成し、クロス製品の各要素をエンドポイントマップデータベースの個別の登録として追加します。

要件

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