gai_strerrorA-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
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 |