Struttura CONNECTDLGSTRUCTA (winnetwk.h)

La struttura CONNECTDLGSTRUCT viene utilizzata 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;

Membri

cbStructure

Tipo: DWORD

Dimensioni, in byte, della struttura CONNECTDLGSTRUCT . Il chiamante deve fornire questo valore.

hwndOwner

Tipo: HWND

Handle per la finestra di proprietario per la finestra di dialogo.

lpConnRes

Tipo: LPNETRESOURCE

Puntatore a una struttura di NETRESOURCE .

Se viene specificato il lpRemoteName membro 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 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
SidTypeUser	L'account è un account utente.
CONNDLG_RO_PATH	Visualizzare un percorso di sola lettura anziché consentire all'utente di digitare un percorso. Questo flag deve essere impostato solo se il membro lpRemoteName della struttura di NETRE SOURCE a cui punta membro lpConnRes non è NULL (o una stringa vuota) e il flag CONNDLG_USE_MRU non è impostato.
CONNDLG_CONN_POINT	Flag interno. Non usare.
CONNDLG_USE_MRU	Immettere i percorsi usati più di recente nella casella di combinazione. Impostare questo valore per simulare la funzione WNetConnectionDialog .
CONNDLG_HIDE_BOX	Mostra la casella di controllo che consente all'utente di ripristinare la connessione all'accesso.
CONNDLG_PERSIST	Ripristinare la connessione all'accesso.
CONNDLG_NOT_PERSIST	Non ripristinare la connessione all'accesso.

 

Per altre informazioni, vedere la sezione Osservazioni seguente.

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.

Osservazioni

Se non viene impostato né il CONNDLG_RO_PATH né il flag CONNDLG_USE_MRU e il membro lpRemoteName della struttura NETRESOURCE non specifica un percorso remoto, per impostazione predefinita la richiesta viene impostata 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 nessuna delle due opzioni è impostata, per impostazione predefinita la finestra di dialogo corrisponde all'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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	winnetwk.h

Vedere anche

NETRESOURCE

WNetConnectionDialog1

Panoramica rete Windows

strutture di rete di Windows