RpcNsBindingImportNext 関数 (rpcnsi.h)

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

RpcNsBindingImportNext 関数は、インターフェイス (および必要に応じてネームサービスデータベースのオブジェクト) を検索し、互換性のあるサーバーのバインドハンドルが見つかった場合に返します。

メモこの関数は、Windows Vista 以降のオペレーティングシステムではサポートされていません。

構文

RPC_STATUS RpcNsBindingImportNext(
  RPC_NS_HANDLE      ImportContext,
  RPC_BINDING_HANDLE *Binding
);

パラメーター

ImportContext

RpcNsBindingImportBegin 関数から返される名前サービスハンドル。

Binding

サーバーのクライアント互換サーバーバインドハンドルへのポインターを返します。

戻り値

値	説明
RPC_S_OK	呼び出しは成功しました。
RPC_S_NO_MORE_BINDINGS	これ以上のバインドはありません。
RPC_S_NAME_SERVICE_UNAVAILABLE	名前サービスを利用できません。

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

解説

RpcNsBindingImportNext 関数は、RpcNsBindingImportBegin 関数の IfSpec パラメーターと ObjUuid パラメーターで指定されたインターフェイスとオブジェクト UUID を提供するサーバーに対して、クライアント互換のサーバーバインドハンドルを 1 つ返します。関数は、サーバーと直接ではなく、ネームサービスデータベースとのみ通信します。

Windows 2000 で有効な RPC 環境では、Active Directory を名前サービスデータベースとして使用し、ランタイム環境が検索を実行する順序は次のとおりです。

ローカルキャッシュで検索します。エントリがない場合は、
Active Directory を検索します。エントリがない場合は、
ドメイン内の他のすべてのディレクトリサービスにブロードキャスト要求を送信します。
エントリが Active Directory に存在するが、エントリに関連付けられている情報がない場合、実行時環境ではこのブロードキャスト要求は発行されないことに注意してください。

返される互換性のあるバインドハンドルには常にオブジェクト UUID が含まれます。この値は RpcNsBindingImportBegin 関数の ObjUuid パラメーターに依存します。 null 以外のオブジェクト UUID が指定された場合、返されるバインドハンドルにはそのオブジェクト UUID が含まれます。ただし、 null オブジェクト UUID または null 値が指定された場合、返されるオブジェクト UUID は次のような結果になります。

サーバーがオブジェクト UUID をエクスポートしなかった場合、返されるバインドハンドルには nil オブジェクト UUID が含まれます。
サーバーが 1 つのオブジェクト UUID をエクスポートした場合、返されるバインドハンドルにはそのオブジェクト UUID が含まれます。
サーバーが複数のオブジェクト UUID をエクスポートした場合、返されるバインドハンドルにはオブジェクト UUID のいずれかが含まれます。次のインポート操作では、返されたオブジェクト UUID を非決定的な方法で選択します。その結果、1 つのサーバーエントリから互換性のあるバインドハンドルごとに異なるオブジェクト UUID を返すことができます。

RpcNsBindingImportNext 関数は、検出された互換性のあるバインドハンドルから 1 つのサーバーバインドハンドルを選択して返します。クライアントアプリケーションは、そのバインドハンドルを使用して、サーバーへのリモートプロシージャ呼び出しを試行できます。クライアントがサーバーとの関係を確立できない場合は、 RpcNsBindingImportNext をもう一度呼び出すことができます。

クライアントが RpcNsBindingImportNext を呼び出すたびに、関数は別のサーバーバインドハンドルを返します。返されるバインドハンドルは順序付けされません。クライアントアプリケーションは、RpcNsBindingInqEntryName 関数を呼び出して、バインドハンドルの取得元のエントリ名に name-service データベースを取得します。検索が name-service データベースの末尾に達すると、 RpcNsBindingInqEntryName はRPC_S_NO_MORE_BINDINGSの状態を返し、バインドパラメーター値 NULL を返します。

RpcNsBindingImportNext 関数は、返された Binding パラメーターによって参照されるデータにストレージを割り当てます。クライアントアプリケーションがバインドハンドルを使用して終了したら、 RpcBindingFree を呼び出してストレージの割り当てを解除する必要があります。 RpcNsBindingImportNext の各呼び出しには、RpcBindingFree への対応する呼び出しが必要です。

クライアントは、インポートコンテキストを削除する RpcNsBindingImportDone 関数を呼び出す役割を担います。また、クライアントは RpcNsBindingImportDone を呼び出してから RpcNsBindingImportBegin を呼び出して、互換性のあるサーバーの新しい検索を開始します。返されるバインドハンドルの順序は新しい検索ごとに異なるため、アプリケーションが実行されるたびにバインドハンドルがアプリケーションに返される順序が異なる場合があります。

要件


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

次の方法で共有

RpcNsBindingImportNext 関数 (rpcnsi.h)

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

その他のリソース