RpcEpRegisterNoReplaceA 関数 (rpcdce.h)

2024-11-20

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

構文

RPC_STATUS RpcEpRegisterNoReplaceA(
  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 戻り値」を参照してください。

備考

RpcEpRegisterNoReplace 関数は、ローカルホストのエンドポイントマップデータベースにエントリを追加します。この関数は、既存のデータベースエントリを置き換えません。

サーバー同じホスト上で複数のインスタンスが実行される場合に RpcEpRegister をするのではなく、RpcEpRegisterNoReplace を使用します。つまり、複数のサーバーインスタンスが同じインターフェイス UUID、オブジェクト UUID、プロトコルシーケンスを一度に提供する場合に、この関数を使用します。

RpcEpRegisterNoReplace呼び出すときにエントリが置き換えられるので、サーバーは実行を停止する前に自身の登録を解除する必要があります。それ以外の場合、RpcEpUnregisterを呼び出さずにサーバーインスタンス実行が停止するたびに古いデータが蓄積されます。古いエントリにより、クライアントが存在しないサーバーにエンドポイントを受信する可能性が高くなります。クライアントは、別のエンドポイントを取得する前に、存在しないサーバーとの通信を試みるために時間を費やします。

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

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

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

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

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

エンドポイントマップデータベースに追加される各要素には、次のものが論理的に含まれます。

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

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

手記

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

必要条件

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

次の方法で共有

必要条件

関連項目

次の方法で共有

RpcEpRegisterNoReplaceA 関数 (rpcdce.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース