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
SidTypeUser	L'account è un account utente.
CONNDLG_RO_PATH	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.
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	Visualizzare 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 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

Vedi anche

NETRESOURCE

WNetConnectionDialog1

Panoramica di Rete Windows (WNet)

Strutture di rete Windows