WNetGetLastErrorA-Funktion (winnetwk.h)

Die WNetGetLastError-Funktion ruft den letzten erweiterten Fehlercode ab, der von einer WNet-Funktion festgelegt wurde. Der Netzwerkanbieter hat diesen Fehlercode gemeldet. Dies ist im Allgemeinen nicht einer der Fehler, die in der SDK-Headerdatei WinError.h enthalten sind.

Syntax

DWORD WNetGetLastErrorA(
  [out] LPDWORD lpError,
  [out] LPSTR   lpErrorBuf,
  [in]  DWORD   nErrorBufSize,
  [out] LPSTR   lpNameBuf,
  [in]  DWORD   nNameBufSize
);

Parameter

[out] lpError

Zeiger auf eine Variable, die den vom Netzwerkanbieter gemeldeten Fehlercode empfängt. Der Fehlercode ist spezifisch für den Netzwerkanbieter.

[out] lpErrorBuf

Zeiger auf den Puffer, der die NULL-endende Zeichenfolge empfängt, die den Fehler beschreibt.

[in] nErrorBufSize

Größe des Puffers, auf den der lpErrorBuf-Parameter in Zeichen verweist. Wenn der Puffer für die Fehlerzeichenfolge zu klein ist, wird die Zeichenfolge abgeschnitten, aber immer noch null beendet. Ein Puffer von mindestens 256 Zeichen wird empfohlen.

[out] lpNameBuf

Zeiger auf den Puffer, der die NULL-endende Zeichenfolge empfängt, die den Netzwerkanbieter identifiziert, der den Fehler ausgelöst hat.

[in] nNameBufSize

Größe des Puffers, auf den der lpNameBuf-Parameter in Zeichen verweist. Wenn der Puffer für die Fehlerzeichenfolge zu klein ist, wird die Zeichenfolge abgeschnitten, aber immer noch null beendet.

Rückgabewert

Wenn die Funktion erfolgreich ist und der letzte vom Netzwerkanbieter gemeldete Fehler abgerufen wird, lautet der Rückgabewert NO_ERROR.

Wenn der Aufrufer einen ungültigen Puffer bereitstellt, wird der Rückgabewert ERROR_INVALID_ADDRESS.

Hinweise

Die WNetGetLastError-Funktion ruft Fehler ab, die für einen Netzwerkanbieter spezifisch sind. Sie können WNetGetLastError aufrufen, wenn eine WNet-Funktion ERROR_EXTENDED_ERROR zurückgibt.

Wie die GetLastError-Funktion gibt WNetGetLastError erweiterte Fehlerinformationen zurück, die auf Threadbasis verwaltet werden. Im Gegensatz zu GetLastError kann die WNetGetLastError-Funktion eine Zeichenfolge zum Melden von Fehlern zurückgeben, die nicht durch einen vorhandenen Fehlercode in WinError.h beschrieben werden.

Weitere Informationen zur Verwendung eines anwendungsdefinierten Fehlerhandlers, der die WNetGetLastError-Funktion aufruft, finden Sie unter Abrufen von Netzwerkfehlern.

Hinweis

Der winnetwk.h-Header definiert WNetGetLastError 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winnetwk.h
Bibliothek	Mpr.lib
DLL	Mpr.dll

Weitere Informationen

Übersicht über Windows-Netzwerke (WNet)

Windows-Netzwerkfunktionen