Funzione WNetDisconnectDialog1A (winnetwk.h)

Articolo
11/20/2024

La funzione WNetDisconnectDialog1 tenta di disconnettere una risorsa di rete. Se la rete sottostante restituisce ERROR_OPEN_FILES, la funzione richiede conferma all'utente. Se si verifica un errore, la funzione informa l'utente. La funzione richiede un DISCDLGSTRUCT per 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 di decidere di disconnettersi, 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 inizializzazione). 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.

Osservazioni

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 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]
piattaforma di destinazione	Finestre
intestazione	winnetwk.h
libreria	Mpr.lib
dll	Mpr.dll