LPNSPLOOKUPSERVICENEXT コールバック関数 (ws2spi.h)
NSPLookupServiceNext 関数は、要求されたサービス情報を取得するために、NSPLookupServiceBegin への以前の呼び出しからハンドルを取得した後に呼び出されます。
プロバイダーは、lpqsResults バッファー内の WSAQUERYSET 構造体を渡します。 クライアントは、
構文
LPNSPLOOKUPSERVICENEXT Lpnsplookupservicenext;
INT Lpnsplookupservicenext(
[in] HANDLE hLookup,
[in] DWORD dwControlFlags,
[in, out] LPDWORD lpdwBufferLength,
[out] LPWSAQUERYSETW lpqsResults
)
{...}
パラメーター
[in] hLookup
WSALookupServiceBeginを
[in] dwControlFlags
次の操作を制御するために使用されるフラグ。 現在、LUP_FLUSHPREVIOUS のみが、大きすぎる結果セットを処理する手段として定義されています。 アプリケーションが十分な大きさのバッファーを提供できない場合、LUP_FLUSHPREVIOUS 設定は、最後の結果セット (大きすぎた) を破棄し、この呼び出しの次のセットに移動するようにプロバイダーに指示します。
[in, out] lpdwBufferLength
lpqsResults
[out] lpqsResults
WSAQUERYSET 構造体に 1 つの結果セットが格納されるメモリ ブロックへのポインター。
戻り値
ルーチンが成功した場合、関数は NO_ERROR (ゼロ) を返す必要があります。 ルーチンが失敗し、WSASetLastErrorを使用して適切なエラー コード
| エラー コード | 意味 |
|---|---|
|
この呼び出し 処理中に NSPLookupServiceEnd の呼び出しが行われました。 呼び出しが取り消されました。
lpqsResults バッファー内のデータは未定義です。
Windows ソケット 2 では、WSAECANCELLED (10103) と |
|
|
使用できるデータはこれ以上ありません。
Windows ソケット 2 では、WSAENOMORE (10102) と |
|
| 指定された参照ハンドルが無効です。 | |
| この操作を実行するのに十分なメモリがありません。 | |
|
lpqsResults バッファーが小さすぎて、WSAQUERYSET セットを含めできませんでした。 |
|
このプロバイダーに対して 1 つ以上のパラメーターが無効であるか、不足しています。 |
|
操作はサポートされていません。 このエラーは、名前空間プロバイダーがこの関数を実装していない場合に返されます。 |
| データベース内で名前が見つかりましたが、指定された制限に一致するデータが見つかりませんでした。 | |
| サービスが不明です。 指定した名前空間にサービスが見つかりません。 |
備考
dwControlFlags この関数で指定され、NSPLookupServiceBegin の時点で指定されたものは、組み合わせのために "制限" として処理されます。 制限は、
dwControlFlags
たとえば、NSPLookupServiceBegin で LUP_RETURN_VERSION が指定されている場合、サービス プロバイダーはバージョンを含むレコードを取得します。
たとえば、
クエリ結果の
次の表に、WSAQUERYSET| WSAQUERYSET メンバー名 | 結果の解釈 |
|---|---|
| **dwSize** | sizeof(WSAQUERYSET) に設定されます。 これはバージョン管理メカニズムとして使用されます。 |
| **dwOutputFlags** | **RESULT_IS_ALIAS** フラグは、これがエイリアスの結果であることを示します。 |
| **lpszServiceInstanceName** | サービス名を含む文字列を参照します。 |
| **lpServiceClassId** | サービス クラスに対応する GUID。 |
| **lpVersion** | 特定のサービス インスタンスのバージョン番号を参照します。 |
| **lpszComment** | 随意。 サービス インスタンスによって提供されるコメント文字列。 |
| **dwNameSpace** | サービス インスタンスが見つかった名前空間。 |
| **lpNSProviderId** | このクエリ結果を提供した特定の名前空間プロバイダーを識別します。 |
| **lpszContext** | サービスが配置されている階層型名前空間のコンテキスト ポイントを指定します。 |
| **dwNumberOfProtocols** | 結果に対して未定義です。 |
| **lpafpProtocols** | 結果に対して未定義の場合、必要なすべてのプロトコル情報は CSADDR_INFO 構造体にあります。 |
| **lpszQueryString** | dwControlFlags |
| **dwNumberOfCsAddrs** | CSADDR_INFO 構造体の配列内の要素の数を示します。 |
| **lpcsaBuffer** | 各要素内に 1 つの完全なトランスポート アドレスが含まれる、CSADDR_INFO 構造体の配列へのポインター。 |
| **lpBlob** | 随意。 プロバイダー固有のエンティティへのポインター。 |
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | ws2spi.h |
関連項目
NSPLookupServiceBegin を
NSPLookupServiceEnd を
WSAQUERYSET の
WSASetLastError の