Struttura DISCDLGSTRUCTA (winnetwk.h)

Articolo
11/20/2024

La struttura DISCDLGSTRUCT viene usata nella funzione WNetDisconnectDialog1 . La struttura contiene le informazioni necessarie per il tentativo di disconnessione.

Sintassi

typedef struct _DISCDLGSTRUCTA {
  DWORD cbStructure;
  HWND  hwndOwner;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  DWORD dwFlags;
} DISCDLGSTRUCTA, *LPDISCDLGSTRUCTA;

Membri

cbStructure

Tipo: DWORD

Dimensione, in byte, della struttura DISCDLGSTRUCT. Il chiamante deve fornire questo valore.

hwndOwner

Tipo: HWND

Handle per la finestra di proprietario della finestra di dialogo.

lpLocalName

Tipo: LPTSTR

Puntatore a un NULLstringa con terminazione che specifica il nome del dispositivo locale reindirizzato alla risorsa di rete, ad esempio "F:" o "LPT1".

lpRemoteName

Tipo: LPTSTR

Puntatore a un NULLstringa con terminazione che specifica il nome della risorsa di rete da disconnettere. Questo membro può essere NULL se viene specificato il membro lpLocalName. Quando si specifica lpLocalName, la connessione alla risorsa di rete reindirizzata da lpLocalName viene disconnessa.

dwFlags

Tipo: DWORD

Set di flag di bit che descrivono la connessione. Questo membro può essere una combinazione dei valori seguenti.

Valore	Significato
DISC_UPDATE_PROFILE	Se questo valore è impostato, la connessione specificata non è più persistente (ripristinata automaticamente ogni volta che l'utente accede). Questo flag è valido solo se il membro lpLocalName specifica un dispositivo locale.
DISC_NO_FORCE	Se questo valore non è impostato, il sistema applica forza quando si tenta di disconnettersi dalla risorsa di rete. Questa situazione si verifica in genere quando l'utente dispone di file aperti tramite la connessione. Questo valore indica che l'utente verrà informato se sono presenti file aperti nella connessione e chiede se vuole comunque disconnettersi. Se l'utente vuole continuare, la procedura di disconnessione tenta nuovamente con forza aggiuntiva.

Valore

Significato

DISC_UPDATE_PROFILE

Se questo valore è impostato, la connessione specificata non è più persistente (ripristinata automaticamente ogni volta che l'utente accede). Questo flag è valido solo se il membro lpLocalName specifica un dispositivo locale.

DISC_NO_FORCE

Se questo valore non è impostato, il sistema applica forza quando si tenta di disconnettersi dalla risorsa di rete.

Questa situazione si verifica in genere quando l'utente dispone di file aperti tramite la connessione. Questo valore indica che l'utente verrà informato se sono presenti file aperti nella connessione e chiede se vuole comunque disconnettersi. Se l'utente vuole continuare, la procedura di disconnessione tenta nuovamente con forza aggiuntiva.

Osservazioni

Nota

L'intestazione winnetwk.h definisce DISCDLGSTRUCT 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

WNetDisconnectDialog1

Panoramica rete Windows

strutture di rete di Windows

Condividi tramite