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 結構中的一個結果集。

傳回值

如果例程成功，函式應該會傳回 NO_ERROR （零）。 如果例程失敗，且必須使用 WSASetLastError來設定適當的錯誤碼，它應該會傳回 SOCKET_ERROR （–1）。

言論

dwControlFlags 在此函式中指定，且在 NSPLookupServiceBegin 時指定的 會以「限制」的方式處理。 這些限制會結合 NSPLookupServiceBegin 時間與 NSPLookupServiceNext 時間的限制。 因此，NSPLookupServiceNext 的旗標 永遠無法增加在 NSPLookupServiceBegin所要求的數據量，不過指定更多或更少旗標不是錯誤。 在指定 NSPLookupServiceNext 指定的旗標 僅適用於該呼叫。

dwControlFlagsLUP_FLUSHPREVIOUS 和 LUP_RES_SERVICE 是合併限制規則的例外狀況（因為它們是行為旗標，而不是「限制」旗標）。 如果在 NSPLookupServiceNext中使用任一旗標，則不論在 NSPLookupServiceBegin設定相同的旗 標，它們都有其定義的效果。

例如，如果在 NSPLookupServiceBegin指定 LUP_RETURN_VERSION，服務提供者會擷取包含版本的記錄。 如果未在 NSPLookupServiceNext指定 LUP_RETURN_VERSION，則傳回的資訊不會包含版本，即使版本可用也一樣。 不會產生任何錯誤。

此外，如果未在 NSPLookupServiceBegin指定 LUP_RETURN_BLOB，但在 NSPLookupServiceNext指定，則傳回的資訊不包含私用數據。 不會產生任何錯誤。

查詢結果

要求

另請參閱

CSADDR_INFO

NSPLookupServiceBegin

NSPLookupServiceEnd

NSP_ROUTINE

WSAQUERYSET

WSASetLastError