GetIpErrorString-Funktion (iphlpapi.h)

Die GetIpErrorString-Funktion ruft eine IP-Hilfsprogrammfehlerzeichenfolge ab.

Syntax

IPHLPAPI_DLL_LINKAGE DWORD GetIpErrorString(
  [in]      IP_STATUS ErrorCode,
  [out]     PWSTR     Buffer,
  [in, out] PDWORD    Size
);

Parameter

[in] ErrorCode

Der abzurufende Fehlercode. Die möglichen Werte für diesen Parameter werden in der Headerdatei Ipexport.h definiert.

[out] Buffer

Ein Zeiger auf den Puffer, der die Fehlercodezeichenfolge enthält, wenn die Funktion mit NO_ERROR zurückgibt.

[in, out] Size

Ein Zeiger auf ein DWORD , der die Länge des Puffers in Zeichen angibt, auf den der Buffer-Parameter verweist, wobei der beendende NULL-Wert (d. h. die Größe des Puffers in Zeichen, minus 1) ausgeschlossen wird.

Rückgabewert

Gibt bei Erfolg NO_ERROR zurück.

Wenn die Funktion fehlschlägt, verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Die GetIpErrorString-Funktion kann verwendet werden, um eine IP-Hilfsprogrammfehlerzeichenfolge für einen IP-Fehlercode abzurufen. Der imErrorCode-Parameter übergebene IP_STATUS Fehlercode wird im Statuselement der ICMP_ECHO_REPLY-, ICMP_ECHO_REPLY32- und ICMPV6_ECHO_REPLY-Strukturen zurückgegeben, die von den Funktionen ICMP und ICMPv6 verwendet werden. Zu den Funktionen, die diese Strukturen verwenden, gehören Icmp6ParseReplies, Icmp6SendEcho2, IcmpParseReplies, IcmpSendEcho, IcmpSendEcho2 und IcmpSendEcho2Ex.

Die Syntax für die GetIpErrorString-Funktion wurde im Microsoft Windows Software Development Kit (SDK) für Windows Vista und höher geringfügig geändert. Der Datentyp für den Buffer-Parameter wurde von PWCHAR in PWSTR geändert.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile iphlpapi.h
Bibliothek Iphlpapi.lib
DLL Iphlpapi.dll

Weitere Informationen

ICMPV6_ECHO_REPLY

ICMP_ECHO_REPLY

ICMP_ECHO_REPLY32

IP-Hilfsfunktionsreferenz

IP-Hilfsprogramm-Startseite

Icmp6ParseReplies

Icmp6SendEcho2

IcmpParseReplies

IcmpSendEcho

IcmpSendEcho2

IcmpSendEcho2Ex