LPNSPLOOKUPSERVICENEXT コールバック関数 (ws2spi.h)

NSPLookupServiceNext 関数は、要求されたサービス情報を取得するために、NSPLookupServiceBegin への以前の呼び出しからハンドルを取得した後に呼び出されます。

プロバイダーは、lpqsResults バッファー内の WSAQUERYSET 構造体を渡します。 クライアントは、WSA_E_NOMOREを返すまでこの関数を呼び出す必要があります。これは、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によって指されるバッファーに格納されている、入力時のサイズ (バイト単位)。 出力時に関数が失敗し、エラーが WSAEFAULT の場合、レコードを取得するために lpqsResults に渡す最小サイズ (バイト単位) が含まれます。

[out] lpqsResults

WSAQUERYSET 構造体に 1 つの結果セットが格納されるメモリ ブロックへのポインター。

戻り値

ルーチンが成功した場合、関数は NO_ERROR (ゼロ) を返す必要があります。 ルーチンが失敗し、WSASetLastErrorを使用して適切なエラー コード 設定する必要がある場合は、SOCKET_ERROR (-1) を返す必要があります。

備考

dwControlFlags この関数で指定され、NSPLookupServiceBegin の時点で指定されたものは、組み合わせのために "制限" として処理されます。 制限は、NSPLookupServiceBegin 時刻と NSPLookupServiceNext 時刻 制限が組み合わされます。 したがって、NSPLookupServiceNext のフラグは、NSPLookupServiceBegin で要求されたデータの量を超えて返されるデータの量を増やすことは決してできませんが、フラグを多くまたは少なく指定するエラーではありません。 NSPLookupServiceNext 指定されたフラグは、その呼び出しにのみ適用。

dwControlFlagsLUP_FLUSHPREVIOUS と LUP_RES_SERVICE は、結合された制限規則の例外です (これらは "制限" フラグではなく動作フラグであるため)。 NSPLookupServiceNextでいずれかのフラグ 使用する場合、NSPLookupServiceBeginでの同じフラグの設定 関係なく、定義された効果があります。

たとえば、NSPLookupServiceBegin で LUP_RETURN_VERSION が指定されている場合、サービス プロバイダーはバージョンを含むレコードを取得します。 LUP_RETURN_VERSION が NSPLookupServiceNext指定されていない場合、返される情報にはバージョンは含まれません。ただし、使用可能な場合でも、 エラーは生成されません。

たとえば、LUP_RETURN_BLOB が NSPLookupServiceBeginで指定されていないが、NSPLookupServiceNextで指定されている場合、返される情報にはプライベート データは含まれません。 エラーは生成されません。

クエリ結果の