Funzione WNetDisconnectDialog (winnetwk.h)

Articolo
03/08/2023

La funzione WNetDisconnectDialog avvia una finestra di dialogo di esplorazione generale per la disconnessione dalle risorse di rete. La funzione richiede un handle per la finestra di proprietario per la finestra di dialogo.

Sintassi

DWORD WNetDisconnectDialog(
  [in] HWND  hwnd,
  [in] DWORD dwType
);

Parametri

[in] hwnd

Handle nella finestra di proprietario per la finestra di dialogo.

[in] dwType

Tipo di risorsa da cui disconnettersi. Questo parametro può avere il valore seguente.

Valore	Significato
RESOURCETYPE_DISK	Disconnette le risorse del disco.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene 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_EXTENDED_ERROR	Si è verificato un errore specifico della rete. Per ottenere una descrizione dell'errore, chiamare la funzione WNetGetLastError .
ERROR_NO_NETWORK	La rete non è disponibile.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente per avviare la finestra di dialogo.

Commenti

La funzione WNetDisconnectDialog restituisce immediatamente e crea una finestra di dialogo per la disconnessione delle unità di rete. Questa finestra di dialogo viene eseguita in modo asincrono in un thread di lavoro.

Se il thread di lavoro viene terminato, viene terminata anche la finestra del proprietario e la finestra di dialogo associata. In questo caso, l'utente potrebbe non essere in grado di interagire con la finestra di dialogo, perché non verrà visualizzato sullo schermo dell'utente o verrà visualizzato brevemente.

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