RpcEpRegisterA 関数 (rpcdce.h)

[アーティクル]
11/20/2024

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

構文

RPC_STATUS RpcEpRegisterA(
  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 関数は、ローカルホストのエンドポイントマップデータベース内のエントリを追加または置換します。指定されたインターフェイス仕様、バインドハンドル、およびオブジェクト UUID に一致する既存のデータベースエントリの場合、この関数はエントリのエンドポイントを、指定されたバインドハンドル内のエンドポイントに置き換えます。

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

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

RpcServerUseAllProtseqs をする
RpcServerUseProtseq の
RpcServerUseProtseqEp の
RpcServerUseAllProtseqsIf
RpcServerUseProtseqIf をする

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

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

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

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

手記

rpcdce.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RpcEpRegister を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	rpcdce.h (Rpc.h を含む)
ライブラリ	Rpcrt4.lib
DLL	Rpcrt4.dll

次の方法で共有

RpcEpRegisterA 関数 (rpcdce.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース