WSASetFailConnectOnIcmpError 函式 (ws2tcpip.h)

  • 發行項

設定 TCP_FAIL_CONNECT_ON_ICMP_ERROR 套接字選項的狀態。

語法

INT WSASetFailConnectOnIcmpError(
  [in] SOCKET Socket,
  [in] DWORD  Enabled
);

參數

[in] Socket

識別 TCP 套接字的描述項。

[in] Enabled

類型： DWORD

如果應該啟用 TCP_FAIL_CONNECT_ON_ICMP_ERROR ，則為非零值，否則為零。

傳回值

成功時，函式會傳回 0。 否則，會傳回 SOCKET_ERROR 的值，而且您可以呼叫 WSAGetLastError 來擷取特定的錯誤碼。

備註

此功能可透過 TCP_FAIL_CONNECT_ON_ICMP_ERROR 套接字選項來支援。 WSASetFailConnectOnIcmpError 是設定此套接字選項的類型安全包裝函式，建議您透過 setockopt 進行設定。

規格需求

需求 值
最低支援的用戶端 Windows 10 版本 2004 (10.0;組建 19041)
最低支援的伺服器 Windows Server 版本 2004 (10.0;組建 19041)
目標平台 Windows
標頭 ws2tcpip.h
程式庫 Ws2_32.lib
Dll Ws2_32.dll