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)