LPNSPLOOKUPSERVICEEND 回呼函式 (ws2spi.h)

  • 發行項

系統會呼叫 NSPLookupServiceEnd 函式，在先前呼叫 NSPLookupServiceBegin 和 NSPLookupServiceNext 之後釋放句柄。

處理 NSPLookupServiceNext 時，可以在另一個線程上接收 NSPLookupServiceEnd 呼叫。 這表示用戶端已取消要求，而且提供者應該關閉句柄並從 NSPLookupServiceNext 呼叫傳回，並將最後一個錯誤設定為 WSA_E_CANCELLED。

語法

LPNSPLOOKUPSERVICEEND Lpnsplookupserviceend;

INT Lpnsplookupserviceend(
  [in] HANDLE hLookup
)
{...}

參數

[in] hLookup

先前由呼叫取得的句柄
NSPLookupServiceBegin。

傳回值

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

錯誤碼 意義
WSA_INVALID_HANDLE
 句柄無效。
WSA_NOT_ENOUGH_MEMORY
 記憶體不足，無法執行這項作業。
WSAEOPNOTSUPP
 不支援此作業。 如果命名空間提供者未實作此函式，就會傳回此錯誤。

備註

在 Windows Sockets 2 中， WSAECANCELLED 和 WSA_E_CANCELLED定義了衝突的錯誤碼。 未來版本將會移除錯誤碼 WSAECANCELLED ，且只會保留WSA_E_CANCELLED。 命名空間提供者應該使用WSA_E_CANCELLED錯誤碼來維持與最廣泛的應用程式相容性。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 ws2spi.h

另請參閱

NSPLookupServiceBegin

NSPLookupServiceNext

NSP_ROUTINE

WSASetLastError