LPNSPV2LOOKUPSERVICEEND回呼函式 (ws2spi.h)

發行項
03/04/2024

系統會呼叫 NSPv2LookupServiceEnd 函式，以在先前呼叫 NSPv2LookupServiceBegin 和 NSPv2LookupServiceNextEx 之後釋放句柄。

語法

LPNSPV2LOOKUPSERVICEEND Lpnspv2lookupserviceend;

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

參數

[in] hLookup

呼叫之前取得的句柄
NSPv2LookupServiceBegin。

傳回值

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

錯誤碼	意義
WSA_INVALID_HANDLE	句柄無效。
WSA_NOT_ENOUGH_MEMORY	記憶體不足，無法執行這項作業。

備註

NSPv2LookupServiceEnd 函式會作為 Windows Vista 和更新版本上可用的命名空間服務提供者版本 2 (NSPv2) 架構的一部分。

在 Windows Vista 和 Windows Server 2008 上， NSPv2LookupServiceEnd 函式只能用於NS_EMAIL命名空間提供者上的作業。

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

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

規格需求

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