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 |