Freigeben über


WNetRestoreConnectionW-Funktion (winnetwk.h)

[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