LPNSPV2LOOKUPSERVICEEND回呼函式 (ws2spi.h)
系統會呼叫 NSPv2LookupServiceEnd 函式,以在先前呼叫 NSPv2LookupServiceBegin 和 NSPv2LookupServiceNextEx 之後釋放句柄。
語法
LPNSPV2LOOKUPSERVICEEND Lpnspv2lookupserviceend;
INT Lpnspv2lookupserviceend(
[in] HANDLE hLookup
)
{...}
參數
[in] hLookup
呼叫之前取得的句柄
NSPv2LookupServiceBegin。
傳回值
如果例程成功,函式應該會 傳回NO_ERROR (零) 。 它應該會 傳回SOCKET_ERROR (,也就是說,如果例程失敗,則傳回 1) ,而且必須使用 WSASetLastError 設定適當的錯誤碼。
錯誤碼 | 意義 |
---|---|
句柄無效。 | |
記憶體不足,無法執行這項作業。 |
備註
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 |