WNetRestoreConnectionW-Funktion (winnetwk.h)

Artikel
08/27/2023

[WNetRestoreConnectionW ist ab Windows Vista nicht verfügbar.]

Die WNetRestoreConnectionW-Funktion stellt die Verbindung mit einer Netzwerkressource wieder her. Die Funktion fordert den Benutzer bei Bedarf zur Eingabe eines Namens und kennworts auf.

Syntax

DWORD WNetRestoreConnectionW(
  [in] HWND    hWnd,
  [in] LPCWSTR lpDevice
);

Parameter

[in] hWnd

Handle mit dem übergeordneten Fenster, das die Funktion verwendet, um die Benutzeroberfläche (UI) anzuzeigen, die den Benutzer beim Herstellen der Netzwerkverbindung zur Eingabe eines Namens und Kennworts auffordert. Wenn dieser Parameter NULL ist, gibt es kein Besitzerfenster.

[in] lpDevice

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den lokalen Namen des Laufwerks angibt, mit dem eine Verbindung hergestellt werden soll, z. B. "Z:". Wenn dieser Parameter NULL ist, verbindet die Funktion alle persistenten Laufwerke, die in der Registrierung für den aktuellen Benutzer gespeichert sind, erneut.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode, z. B. einer der folgenden Werte.

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Der Aufrufer hat keinen Zugriff auf die Netzwerkressource.
ERROR_ALREADY_ASSIGNED	Das von lpDevice angegebene lokale Gerät ist bereits mit einer Netzwerkressource verbunden.
ERROR_BAD_DEV_TYPE	Der Typ des lokalen Geräts und der Typ der Netzwerkressource stimmen nicht überein.
ERROR_BAD_DEVICE	Der von lpDevice angegebene Wert ist ungültig.
ERROR_BAD_PROFILE	Das Benutzerprofil weist ein falsches Format auf.
ERROR_BUSY	Der Router oder Anbieter ist ausgelastet, möglicherweise initialisiert. Der Aufrufer sollte den Vorgang wiederholen.
ERROR_CANCELLED	Der Versuch, die Verbindung herzustellen, wurde vom Benutzer über ein Dialogfeld von einem der Netzwerkressourcenanbieter oder von einer aufgerufenen Ressource abgebrochen.
ERROR_CANNOT_OPEN_PROFILE	Das System kann das Benutzerprofil nicht öffnen, um persistente Verbindungen zu verarbeiten.
ERROR_DEVICE_ALREADY_REMEMBERED	Ein Eintrag für das Gerät befindet sich bereits im Benutzerprofil.
ERROR_EXTENDED_ERROR	Ein netzwerkspezifischer Fehler ist aufgetreten. Rufen Sie die WNetGetLastError-Funktion auf, um eine Beschreibung des Fehlers zu erhalten.
ERROR_INVALID_PASSWORD	Das angegebene Kennwort ist ungültig.
ERROR_NO_NET_OR_BAD_PATH	Der Vorgang kann nicht ausgeführt werden, weil eine Netzwerkkomponente nicht gestartet wurde oder ein angegebener Name nicht verwendet werden kann.
ERROR_NO_NETWORK	Das Netzwerk ist nicht verfügbar.

Hinweise

Die WNetRestoreConnectionW-Funktion wird unter Windows Vista und höher nicht unterstützt.

Um diese Funktion aufzurufen, rufen Sie zuerst die LoadLibrary-Funktion auf, um Mpr.dll zu laden. Rufen Sie dann die GetProcAddress-Funktion auf, um die Adresse der WNetRestoreConnectionW-Funktion abzurufen.

WNetRestoreConnectionW wird von Winlogon verwendet, um alle persistenten Laufwerkszuordnungen während des interaktiven Anmeldeprozesses wiederherzustellen. Die Funktion wird auch von der Microsoft Windows Shell aufgerufen, um einzelne Laufwerke auf Anforderung des Benutzers wiederherzustellen. Dies kann z. B. der Fall sein, wenn ein Laufwerk bei der Anmeldung nicht wiederhergestellt werden kann und der Benutzer auf das Laufwerk unter dem virtuellen Ordner "Mein Computer" doppelklicken.

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

Share via