WSAGetIcmpErrorInfo-Funktion (ws2tcpip.h)

  • Artikel

Ruft Informationen zu einem ICMP-Fehler ab, der während der Verbindungseinrichtung auf einem TCP-Socket empfangen wurde.

Syntax

INT WSAGetIcmpErrorInfo(
  [in]  SOCKET          Socket,
  [out] ICMP_ERROR_INFO *Info
);

Parameter

[in] Socket

Ein Deskriptor, der einen TCP-Socket identifiziert.

[out] Info

Typ: DWORD*

Ein Zeiger auf eine ICMP_ERROR_INFO-Struktur . Bei Erfolg initialisiert die -Funktion die -Struktur.

Rückgabewert

Bei Erfolg gibt die Funktion 0 zurück. Andernfalls wird der Wert SOCKET_ERROR zurückgegeben, und Sie können einen bestimmten Fehlercode abrufen, indem Sie WSAGetLastError aufrufen.

Hinweise

Wenn seit dem letzten Verbindungsaufruf kein ICMP-Fehler empfangen wurde, wird WSANO_DATA zurückgegeben. Diese Funktionalität wird über die Socketoption TCP_ICMP_ERROR_INFO unterstützt. WSAGetIcmpErrorInfo ist ein typsicherer Wrapper zum Abrufen dieser Socketoption und wird über getsockopt empfohlen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 2004 (10.0; Build 19041)
Unterstützte Mindestversion (Server) Windows Server, Version 2004 (10.0; Build 19041)
Zielplattform Windows
Kopfzeile ws2tcpip.h
Bibliothek Ws2_32.lib
DLL Ws2_32.dll