Freigeben über


gai_strerrorW-Funktion (ws2tcpip.h)

Die gai_strerror-Funktion unterstützt das Drucken von Fehlermeldungen basierend auf den EAI_*-Fehlern, die von der getaddrinfo-Funktion zurückgegeben werden. Beachten Sie, dass die gai_strerror-Funktion nicht threadsicher ist und daher die Verwendung herkömmlicher Windows Sockets-Funktionen wie der WSAGetLastError-Funktion empfohlen wird.

Syntax

WCHAR * gai_strerrorW(
  [in] int ecode
);

Parameter

[in] ecode

Fehlercode aus der Liste der verfügbaren getaddrinfo Fehlercodes. Eine vollständige Auflistung der Fehlercodes finden Sie in der getaddrinfo-Funktion.

Rückgabewert

Nichts

Bemerkungen

Wenn der ecode Parameter kein Fehlercodewert ist, der getaddrinfo zurückgibt, gibt die gai_strerror-Funktion einen Zeiger auf eine Zeichenfolge zurück, die einen unbekannten Fehler angibt.

Anmerkung

Der ws2tcpip.h-Header definiert gai_strerror als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Zielplattform- Fenster
Header- ws2tcpip.h

Siehe auch

WSAGetLastError-

Winsock-Funktionen

Winsock Reference

getaddrinfo-