LPNSPLOOKUPSERVICEBEGIN

NSPLookupServiceBegin 関数は、 WSAQUERYSET 構造体に格納された情報によって制約される、ネームサービスプロバイダーに対するクライアントからのクエリを開始します。

NSPLookupServiceBegin はハンドルのみを返します。実際の結果を取得するには、このハンドルを以降の NSPLookupServiceNext の呼び出しで使用します。この操作はキャンセルできないため、短時間で実行されるように実装してください。ネットワーククエリを開始することは差し支えありませんが、この関数は正常に返るために応答を必要としてはなりません。

処理が成功した場合、この関数は NO_ERROR (0) を返します。処理が失敗した場合は SOCKET_ERROR (–1) を返し、 WSASetLastError を使用して適切なエラーコードを設定しなければなりません。

呼び出しで LUP_CONTAINERS を指定する場合は、他の制約値をすべて指定しないようにしてください。指定された場合、ネームサービスプロバイダーは、コンテナーに対してその制約をサポートできるかどうかを判断しなければなりません。できない場合はエラーを返してください。

ネームサービスプロバイダーによっては、コンテナーを検索する別の手段を備えていることがあります。たとえば、コンテナーがすべて特定の既知の型、または既知の型の集合であれば、それらを検索するためのクエリ制約を作成できます。ネームサービスプロバイダーがコンテナーを特定するどのような手段を備えていても、LUP_CONTAINERS と LUP_NOCONTAINERS が優先されます。したがって、コンテナーを含むクエリ制約が指定されていても、LUP_NOCONTAINERS を指定するとコンテナー項目は返されません。同様に、クエリ制約がどのようなものであっても、LUP_CONTAINERS が指定された場合はコンテナーのみを返してください。名前空間がコンテナーをサポートしておらず、LUP_CONTAINERS が指定された場合は、WSANO_DATA を返してください。

あるコンテナー内のコンテナーを取得する推奨される方法は、次の呼び出しです。

dwStatus = NSPLookupServiceBegin(
    lpqsRestrictions,
    LUP_CONTAINERS,
    lphLookup);

この呼び出しに続けて、必要な回数だけ NSPLookupServiceNext を呼び出します。これにより、開始コンテキストの直下に含まれるすべてのコンテナーが返されます。つまり、これは深い階層まで探索するクエリではありません。これを利用すると、階層をたどってアドレス空間の構造をマッピングし、必要に応じて選択したコンテナーの内容を列挙できます。以降の NSPLookupServiceBegin の呼び出しでは、前回の呼び出しで返されたコンテナーを使用します。

クエリの作成

前述のとおり、クエリを限定するために、 WSAQUERYSET 構造体を NSPLookupServiceBegin の入力パラメーターとして使用します。次の表は WSAQUERYSET のメンバー名と、 WSAQUERYSET を使用してクエリを構成する方法を示しています。メンバーが (省略可能) と記されている場合は NULL ポインターを指定でき、そのパラメーターを検索条件として使用しないことを意味します。詳細については、クエリ関連のデータ構造を参照してください。