Funzione WNetDisconnectDialog1A (winnetwk.h)

Articolo
03/08/2023

La funzione WNetDisconnectDialog1 tenta di disconnettere una risorsa di rete. Se la rete sottostante restituisce ERROR_OPEN_FILES, la funzione richiede la conferma dell'utente. Se si verifica un errore, la funzione informa l'utente. La funzione richiede a DISCDLGSTRUCT di specificare i parametri per il tentativo di disconnessione.

Sintassi

DWORD WNetDisconnectDialog1A(
  [in] LPDISCDLGSTRUCTA lpConnDlgStruct
);

Parametri

[in] lpConnDlgStruct

Puntatore a una struttura DISCDLGSTRUCT . La struttura specifica il comportamento per il tentativo di disconnessione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR. Se l'utente annulla la finestra di dialogo, il valore restituito è -1.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema, ad esempio uno dei valori seguenti.

Codice restituito	Descrizione
ERROR_CANCELLED	Quando il sistema ha richiesto all'utente una decisione sulla disconnessione, l'utente ha scelto di non disconnettersi.
ERROR_OPEN_FILES	Impossibile disconnettersi perché l'utente usa attivamente la connessione.
ERROR_BUSY	Il provider di rete è occupato (possibilmente inizializzando). Il chiamante deve riprovare.
ERROR_NO_NETWORK	La rete non è disponibile.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente per avviare la finestra di dialogo.
ERROR_EXTENDED_ERROR	Si è verificato un errore specifico della rete. Chiamare la funzione WNetGetLastError per ottenere una descrizione dell'errore.

Commenti

Nota

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


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winnetwk.h
Libreria	Mpr.lib
DLL	Mpr.dll