共用方式為


LPNSPV2LOOKUPSERVICEEND回呼函式 (ws2spi.h)

系統會呼叫 NSPv2LookupServiceEnd 函式,以在先前呼叫 NSPv2LookupServiceBeginNSPv2LookupServiceNextEx 之後釋放句柄。

語法

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 中, WSAECANCELLEDWSA_E_CANCELLED定義了衝突的錯誤碼。 未來版本將會移除錯誤碼 WSAECANCELLED ,而且只會保留WSA_E_CANCELLED。 命名空間提供者應該使用WSA_E_CANCELLED錯誤碼來維持與最廣泛應用程式範圍的相容性。

規格需求

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

另請參閱

NSPV2_ROUTINE

NSPv2Cleanup

NSPv2ClientSessionRundown

NSPv2LookupServiceBegin

NSPv2LookupServiceNextEx

NSPv2SetServiceEx

NSPv2Startup

WSAQUERYSET2

WSASetLastError