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