Funzione WNetRestoreConnectionW (winnetwk.h)

Articolo
08/27/2023

[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
ERROR_ACCESS_DENIED	Il chiamante non ha accesso alla risorsa di rete.
ERROR_ALREADY_ASSIGNED	Il dispositivo locale specificato da lpDevice è già connesso a una risorsa di rete.
ERROR_BAD_DEV_TYPE	Il tipo di dispositivo locale e il tipo di risorsa di rete non corrispondono.
ERROR_BAD_DEVICE	Il valore specificato da lpDevice non è valido.
ERROR_BAD_PROFILE	Il profilo utente è in formato non corretto.
ERROR_BUSY	Il router o il provider è occupato, possibilmente inizializzando. Il chiamante deve riprovare.
ERROR_CANCELLED	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.
ERROR_CANNOT_OPEN_PROFILE	Il sistema non è in grado di aprire il profilo utente per elaborare connessioni persistenti.
ERROR_DEVICE_ALREADY_REMEMBERED	Una voce per il dispositivo è già presente nel profilo utente.
ERROR_EXTENDED_ERROR	Si è verificato un errore specifico della rete. Chiamare la funzione WNetGetLastError per ottenere una descrizione dell'errore.
ERROR_INVALID_PASSWORD	La password specificata non è valida.
ERROR_NO_NET_OR_BAD_PATH	Impossibile eseguire l'operazione perché un componente di rete non viene avviato o perché non è possibile usare un nome specificato.
ERROR_NO_NETWORK	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

Vedi anche

Panoramica di Rete Windows (WNet)

Funzioni di rete Windows

Condividi tramite