Freigeben über


WNetGetLastErrorA-Funktion (winnetwk.h)

Die WNetGetLastError--Funktion ruft den neuesten erweiterten Fehlercode ab, der von einer WNet-Funktion festgelegt wurde. Der Netzwerkanbieter hat diesen Fehlercode gemeldet; es ist in der Regel 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

Zeigen Sie auf den Puffer, der die mit Null beendete 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 trotzdem NULL beendet. Es wird ein Puffer von mindestens 256 Zeichen empfohlen.

[out] lpNameBuf

Zeigen Sie auf den Puffer, der die mit Null beendete 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 trotzdem NULL beendet.

Rückgabewert

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

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

Bemerkungen

Die WNetGetLastError--Funktion ruft Fehler ab, die spezifisch für einen Netzwerkanbieter 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 pro Thread verwaltet werden. Im Gegensatz zu GetLastError-kann die WNetGetLastError--Funktion eine Zeichenfolge für die Meldung von Fehlern zurückgeben, die nicht durch 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.

Anmerkung

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
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Zielplattform- Fenster
Header- winnetwk.h
Library Mpr.lib
DLL- Mpr.dll

Siehe auch

übersicht über Windows Networking (WNet)

Windows-Netzwerkfunktionen