Función WNetDisconnectDialog (winnetwk.h)

Artículo
03/08/2023

La función WNetDisconnectDialog inicia un cuadro de diálogo de exploración general para desconectar de los recursos de red. La función requiere un identificador para la ventana del propietario del cuadro de diálogo.

Sintaxis

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

Parámetros

[in] hwnd

Identificador de la ventana de propietario del cuadro de diálogo.

[in] dwType

Tipo de recurso del que se va a desconectar. Este parámetro puede tener el siguiente valor.

Value	Significado
RESOURCETYPE_DISK	Se desconecta de los recursos de disco.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR. Si el usuario cancela el cuadro de diálogo, el valor devuelto es –1.

Si se produce un error en la función, el valor devuelto es un código de error del sistema, como uno de los siguientes valores.

Código devuelto	Descripción
ERROR_EXTENDED_ERROR	Error específico de la red. Para obtener una descripción del error, llame a la función WNetGetLastError .
ERROR_NO_NETWORK	La red no está disponible.
ERROR_NOT_ENOUGH_MEMORY	No hay memoria suficiente para iniciar el cuadro de diálogo.

Comentarios

La función WNetDisconnectDialog devuelve inmediatamente y crea un cuadro de diálogo para desconectar unidades en red. Este cuadro de diálogo se ejecuta de forma asincrónica en un subproceso de trabajo.

Si finaliza el subproceso de trabajo, también se finaliza la ventana del propietario y su cuadro de diálogo asociado. Si esto ocurre, es posible que el usuario no pueda interactuar con el cuadro de diálogo, ya que no aparecerá en la pantalla del usuario o aparecerá brevemente.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winnetwk.h
Library	Mpr.lib
Archivo DLL	Mpr.dll