Funzione WNetConnectionDialog1A (winnetwk.h)
La funzione WNetConnectionDialog1 visualizza una finestra di dialogo di esplorazione generale per la connessione alle risorse di rete. La funzione richiede un CONNECTDLGSTRUCT per stabilire i parametri della finestra di dialogo.
Sintassi
DWORD WNetConnectionDialog1A(
[in, out] LPCONNECTDLGSTRUCTA lpConnDlgStruct
);
Parametri
[in, out] lpConnDlgStruct
Puntatore a una struttura CONNECTDLGSTRUCT . La struttura stabilisce i parametri del dialogo di esplorazione.
Valore restituito
Se l'utente annulla la finestra di dialogo, la funzione restituisce –1. Se la funzione ha esito positivo, restituisce NO_ERROR. Inoltre, se la chiamata ha esito positivo, il membro dwDevNum della struttura CONNECTDLGSTRUCT contiene il numero del dispositivo connesso.
In genere, questa finestra di dialogo restituisce un errore solo se l'utente non può immettere una sessione di dialogo. Ciò è dovuto al fatto che gli errori che si verificano dopo una sessione di dialogo vengono segnalati direttamente all'utente. Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema, ad esempio uno dei valori seguenti.
Codice restituito | Descrizione |
---|---|
|
Vengono impostate sia le CONNDLG_RO_PATH che le opzioni della finestra di dialogo CONNDLG_USE_MRU. Le opzioni della finestra di dialogo vengono specificate dal membro dwFlags della struttura CONNECTDLGSTRUCT . -oppure- Vengono impostate sia le CONNDLG_PERSIST che le opzioni della finestra di dialogo CONNDLG_NOT_PERSIST. -oppure- L'opzione della finestra di dialogo CONNDLG_RO_PATH è impostata e il membro lpRemoteName della struttura NETRESOURCE non punta a una rete remota. La struttura CONNECTDLGSTRUCT punta a una struttura NETRESOURCE . |
|
Il membro dwType della struttura NETRESOURCE non è impostato su RESOURCETYPE_DISK. |
|
Il provider di rete è occupato (possibilmente inizializzazione). Il chiamante deve riprovare. |
|
La rete non è disponibile. |
|
Memoria insufficiente per visualizzare la finestra di dialogo. |
|
Si è verificato un errore specifico della rete. Chiamare WNetGetLastError per ottenere una descrizione dell'errore. |
Commenti
Nota
L'intestazione winnetwk.h definisce WNetConnectionDialog1 come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 |