Struttura DISCDLGSTRUCTA (winnetwk.h)

Articolo
03/04/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;

Members

cbStructure

Tipo: DWORD

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

hwndOwner

Tipo: HWND

Handle per la finestra di proprietario della finestra di dialogo.

lpLocalName

Tipo: LPTSTR

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

lpRemoteName

Tipo: LPTSTR

Puntatore a una stringa con terminazione NULL che specifica il nome della risorsa di rete da disconnettere. Questo membro può essere NULL se è 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ù permanente (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 si applica forza quando si tenta di disconnettersi dalla risorsa di rete. Questa situazione si verifica in genere quando l'utente ha file aperti tramite la connessione. Questo valore significa che l'utente verrà informato se sono presenti file aperti nella connessione e chiede se vuole comunque disconnettersi. Se l'utente vuole procedere, la procedura di disconnessione tenta nuovamente con forza aggiuntiva.

Valore

Significato

DISC_UPDATE_PROFILE

Se questo valore è impostato, la connessione specificata non è più permanente (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 si applica forza quando si tenta di disconnettersi dalla risorsa di rete.

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

Commenti

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 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

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

WNetDisconnectDialog1

Panoramica di Windows Networking (WNet)

Strutture di rete Di Windows

Condividi tramite