Funzione WNetRestoreConnectionW (winnetwk.h)
[WNetRestoreConnectionW non è disponibile per l'uso a partire da Windows Vista.]
La funzione WNetRestoreConnectionW ripristina la connessione a una risorsa di rete. La funzione richiede all'utente, se necessario, un nome e una password.
Sintassi
DWORD WNetRestoreConnectionW(
[in] HWND hWnd,
[in] LPCWSTR lpDevice
);
Parametri
[in] hWnd
Gestire la finestra padre usata dalla funzione per visualizzare l'interfaccia utente che richiede all'utente un nome e una password quando si effettua la connessione di rete. Se questo parametro è NULL, non esiste alcuna finestra del proprietario.
[in] lpDevice
Puntatore a una stringa Unicode con terminazione null che specifica il nome locale dell'unità da connettere, ad esempio "Z:". Se questo parametro è NULL, la funzione riconnette tutte le unità persistenti archiviate nel Registro di sistema per l'utente corrente.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è NO_ERROR.
Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema, ad esempio uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Il chiamante non ha accesso alla risorsa di rete. |
|
Il dispositivo locale specificato da lpDevice è già connesso a una risorsa di rete. |
|
Il tipo di dispositivo locale e il tipo di risorsa di rete non corrispondono. |
|
Il valore specificato da lpDevice non è valido. |
|
Il profilo utente è in formato non corretto. |
|
Il router o il provider è occupato, possibilmente inizializzando. Il chiamante deve riprovare. |
|
Il tentativo di effettuare la connessione è stato annullato dall'utente tramite una finestra di dialogo da uno dei provider di risorse di rete o da una risorsa chiamata. |
|
Il sistema non è in grado di aprire il profilo utente per elaborare connessioni persistenti. |
|
Una voce per il dispositivo è già presente nel profilo utente. |
|
Si è verificato un errore specifico della rete. Chiamare la funzione WNetGetLastError per ottenere una descrizione dell'errore. |
|
La password specificata non è valida. |
|
Impossibile eseguire l'operazione perché un componente di rete non viene avviato o perché non è possibile usare un nome specificato. |
|
La rete non è disponibile. |
Commenti
La funzione WNetRestoreConnectionW non è supportata in Windows Vista e versioni successive.
Per chiamare questa funzione, chiamare prima la funzione LoadLibrary per caricare Mpr.dll. Chiamare quindi la funzione GetProcAddress per recuperare l'indirizzo della funzione WNetRestoreConnectionW .
WNetRestoreConnectionW viene usato da Winlogon per ripristinare tutti i mapping di unità persistenti durante il processo di accesso interattivo. La funzione viene chiamata anche da Microsoft Windows Shell per riconnettere singole unità alla richiesta dell'utente. Ciò può verificarsi, ad esempio, quando un'unità non riesce a riconnettersi all'accesso e l'utente fa doppio clic sull'unità nella cartella Virtuale Computer personale.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winnetwk.h |
| Libreria | Mpr.lib |
| DLL | Mpr.dll |