Struttura CONNECTDLGSTRUCTA (winnetwk.h)
La struttura CONNECTDLGSTRUCT viene usata dalla funzione WNetConnectionDialog1 per stabilire i parametri della finestra di dialogo di esplorazione.
Sintassi
typedef struct _CONNECTDLGSTRUCTA {
DWORD cbStructure;
HWND hwndOwner;
LPNETRESOURCEA lpConnRes;
DWORD dwFlags;
DWORD dwDevNum;
} CONNECTDLGSTRUCTA, *LPCONNECTDLGSTRUCTA;
Members
cbStructure
Tipo: DWORD
Dimensioni, in byte, della struttura CONNECTDLGSTRUCT . Il chiamante deve specificare questo valore.
hwndOwner
Tipo: HWND
Handle della finestra proprietario per la finestra di dialogo.
lpConnRes
Tipo: LPNETRESOURCE
Puntatore a una struttura NETRESOURCE .
Se viene specificato il membro lpRemoteName di NETRESOURCE , verrà immesso nel campo percorso della finestra di dialogo. Ad eccezione del membro dwType , tutti gli altri membri della struttura NETRESOURCE devono essere impostati su NULL. Il membro dwType deve essere uguale a RESOURCETYPE_DISK.
Il sistema non supporta il flag di RESOURCETYPE_PRINT per l'esplorazione e la connessione alle risorse di stampa.
dwFlags
Tipo: DWORD
Set di flag di bit che descrivono le opzioni per la visualizzazione della finestra di dialogo. Questo membro può essere una combinazione dei valori seguenti.
| Valore | Significato |
|---|---|
|
L'account è un account utente. |
|
Visualizzare un percorso di sola lettura anziché consentire all'utente di digitare in un percorso.
Questo flag deve essere impostato solo se il membro lpRemoteName della struttura NETRESOURCE puntato a da lpConnRes membro non è NULL (o una stringa vuota) e il flag CONNDLG_USE_MRU non è impostato. |
|
Flag interno. Non usare. |
|
Immettere i percorsi usati più di recente nella casella di combinazione. Impostare questo valore per simulare la funzione WNetConnectionDialog . |
|
Visualizzare la casella di controllo che consente all'utente di ripristinare la connessione all'accesso. |
|
Ripristinare la connessione all'accesso. |
|
Non ripristinare la connessione all'accesso. |
Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
dwDevNum
Tipo: DWORD
Se la chiamata alla funzione WNetConnectionDialog1 ha esito positivo, questo membro restituisce il numero del dispositivo connesso. Il valore è 1 per A:, 2 per B:, 3 per C:e così via. Se l'utente ha effettuato una connessione senza dispositivo, il valore è -1.
Commenti
Se non viene impostato né il CONNDLG_RO_PATH né il flag di CONNDLG_USE_MRU e il membro lpRemoteName della struttura NETRESOURCE non specifica un percorso remoto, la richiesta viene impostata per impostazione predefinita sul tipo di visualizzazione della finestra di dialogo CONNDLG_RO_PATH.
I valori CONNDLG_PERSIST e CONNDLG_NOT_PERSIST non possono essere impostati entrambi. Se nessuno è impostato, la finestra di dialogo viene impostata per impostazione predefinita sull'ultima opzione selezionata in questa finestra di dialogo per il tipo specifico di connessione del dispositivo.
Nota
L'intestazione winnetwk.h definisce CONNECTDLGSTRUCT come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | winnetwk.h |