GetAddrInfoExCancel 函式 (ws2tcpip.h)
GetAddrInfoExCancel 函式會取消 GetAddrInfoEx 函式的異步操作。
語法
INT WSAAPI GetAddrInfoExCancel(
[in] LPHANDLE lpHandle
);
參數
[in] lpHandle
要取消之異步操作的句柄。 這是 GetAddrInfoEx 函式在 lpNameHandle 參數中傳回的句柄。
傳回值
成功時， GetAddrInfoExCancel 會 傳回 NO_ERROR (0) 。 失敗會傳回非零的 Windows Sockets 錯誤碼，如 Windows Sockets 錯誤碼中找到。
備註
GetAddrInfoExCancel 函式會取消異步 GetAddrInfoEx 作業。 結果是會立即叫用使用者的完成機制回呼或事件。 不會傳回任何結果，而且 針對 GetAddrInfoEx 異步操作傳回的錯誤碼會設定為 WSA_E_CANCELLED。 如果 GetAddrInfoEx 要求已完成或逾時，或句柄無效，則 GetAddrInfoExCancel 函式會傳回WSA_INVALID_HANDLE。
由於許多基礎作業 (舊版名稱服務提供者，例如) 是同步的，因此不會實際取消這些作業。 這些作業將會繼續執行並取用資源。 一旦最後一個未完成的名稱服務提供者要求完成，資源就會釋出。
Windows 8.1 和 Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 及更新版本上的 Windows 市集應用程式支援此函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8.1，Windows 8 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | ws2tcpip.h |
| 程式庫 | Ws2_32.lib |
| Dll | Ws2_32.dll |