WNetSetLastErrorA-Funktion (npapi.h)

  • Artikel

Legt erweiterte Fehlerinformationen fest. Netzwerkanbieter sollten diese Funktion anstelle von SetLastError aufrufen.

Bei Bedarf ruft der Multiple Provider Router (MPR) SetLastError auf, um den windows-Fehler festzulegen, der von einem Netzwerkanbieter zurückgegeben wird.

Syntax

void WNetSetLastErrorA(
  [in] DWORD err,
  [in] LPSTR lpError,
  [in] LPSTR lpProviders
);

Parameter

[in] err

Ein aufgetretene Fehler. Dies ist ein netzwerkspezifischer Fehlercode.

[in] lpError

Zeichenfolge, die den netzwerkspezifischen Fehler beschreibt.

[in] lpProviders

Zeichenfolge, die den Netzwerkanbieter benennt, der den Fehler ausgelöst hat.

Rückgabewert

Keine

Bemerkungen

Diese Funktion wird vom Windows-Betriebssystem implementiert und kann von Netzwerkanbietern aufgerufen werden.

Ein Anbieter sollte diese Funktion verwenden, um Fehler zu melden, die anbieterspezifische Informationen enthalten. Die Fehlerinformationen werden gespeichert, bis sie von einem anderen Aufruf von WNetSetLastError im selben Thread überschrieben werden.

Die empfohlene Möglichkeit für eine Anbieterfunktion, allgemeine Fehler zu behandeln, besteht darin, die folgende Anweisung zu verwenden.

return(providerError);

In dieser Anweisung ist providerError ein Windows-Fehlercode, z. B. einer der Rückgabecodes, die für die Anbieter-API in diesem Dokument aufgeführt sind.

Bei anbieterspezifischen Fehlern sollte ein Anbieter die folgenden Schritte ausführen.

//  Set up lpErrorString to be the error to be reported.
WNetSetLastError(providerError,
lpErrorString,
lpProviderName) ;
return(ERROR_EXTENDED_ERROR) ;

In diesem Fall ist providerError der anbieterspezifische Fehlercode.

Anbieter müssen SetLastError nicht aufrufen, bevor sie von einer Anbieterfunktion zurückgegeben werden. Der MPR ruft SetLastError auf, um den windows-Fehler festzulegen, der von einem Anbieter zurückgegeben wird, wenn dies zur Erfüllung von Anwendungen erforderlich ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile npapi.h
Bibliothek Mpr.lib
DLL Mpr.dll