Funzione WNetConnectionDialog (winnetwk.h)
La funzione WNetConnectionDialog avvia una finestra di dialogo di esplorazione generale per la connessione alle risorse di rete. La funzione richiede un handle per la finestra proprietario della finestra di dialogo.
Sintassi
DWORD WNetConnectionDialog(
[in] HWND hwnd,
[in] DWORD dwType
);
Parametri
[in] hwnd
Gestire la finestra del proprietario per la finestra di dialogo.
[in] dwType
Tipo di risorsa per consentire le connessioni. Questo parametro può essere il valore seguente.
| Valore | Significato |
|---|---|
|
Connessioni alle risorse del disco. |
Valore restituito
Se la funzione ha esito positivo, il valore restituito è NO_ERROR. Se l'utente annulla la finestra di dialogo, la funzione restituisce –1.
Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema, ad esempio uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Si è verificato un errore specifico della rete. Per ottenere una descrizione dell'errore, chiamare la funzione WNetGetLastError . |
|
La password specificata non è valida. |
|
La rete non è disponibile. |
|
Memoria insufficiente per avviare la finestra di dialogo. |
Commenti
Se l'utente fa clic su OK nella finestra di dialogo, la connessione di rete richiesta verrà eseguita quando viene restituita la funzione WNetConnectionDialog .
Se la funzione tenta di effettuare una connessione e il provider di rete restituisce il messaggio ERROR_INVALID_PASSWORD, il sistema richiede all'utente di immettere una password. Il sistema usa la nuova password in un altro tentativo di effettuare la connessione.
Requisiti
| 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 |