gai_strerrorA-Funktion (ws2tcpip.h)

Artikel
03/04/2024

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

char * gai_strerrorA(
  [in] int ecode
);

Parameter

[in] ecode

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

Rückgabewert

Gibt einen Zeiger auf eine Zeichenfolge zurück, die die Fehlermeldung enthält.

Hinweise

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

Hinweis

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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ws2tcpip.h

Weitere Informationen