WSASetLastError-Funktion (winsock.h)

  • Artikel

Die WSASetLastError-Funktion legt den Fehlercode fest, der über die WSAGetLastError-Funktion abgerufen werden kann.

Syntax

void WSASetLastError(
  [in] int iError
);

Parameter

[in] iError

Integer, die den Fehlercode angibt, der von einem nachfolgenden WSAGetLastError-Aufruf zurückgegeben werden soll.

Rückgabewert

Diese Funktion generiert keine Rückgabewerte.

Fehlercode Bedeutung
WSANOTINITIALISIERT
 Vor der Verwendung dieser Funktion muss ein erfolgreicher WSAStartup-Aufruf erfolgen.

Hinweise

Die WSASetLastError-Funktion ermöglicht es einer Anwendung, den Fehlercode festzulegen, der von einem nachfolgenden WSAGetLastError-Aufruf für den aktuellen Thread zurückgegeben wird. Beachten Sie, dass jede nachfolgende Windows Sockets-Routine, die von der Anwendung aufgerufen wird, den Von dieser Routine festgelegten Fehlercode überschreibt.

Der von WSASetLastError festgelegte Fehlercode unterscheidet sich von dem Fehlercode, der durch Aufrufen der Funktion getockopt mit SO_ERROR zurückgegeben wird.

Die von dieser Funktion verwendeten Windows Sockets-Fehlercodes sind unter Windows Sockets-Fehlercodes aufgeführt.

Windows Phone 8: Diese Funktion wird für Windows Phone Store-Apps ab Windows Phone 8 unterstützt.

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1, Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile winsock.h (Winsock2.h einschließen)
Bibliothek Ws2_32.lib
DLL Ws2_32.dll

Weitere Informationen

WSAGetLastError

Windows Sockets-Fehlercodes

Winsock-Funktionen

Winsock-Referenz

getsockopt