Función WNetDisconnectDialog1A (winnetwk.h)

Artículo
08/27/2023

La función WNetDisconnectDialog1 intenta desconectar un recurso de red. Si la red subyacente devuelve ERROR_OPEN_FILES, la función solicita confirmación al usuario. Si hay algún error, la función informa al usuario. La función requiere un DISCDLGSTRUCT para especificar los parámetros para el intento de desconexión.

Sintaxis

DWORD WNetDisconnectDialog1A(
  [in] LPDISCDLGSTRUCTA lpConnDlgStruct
);

Parámetros

[in] lpConnDlgStruct

Puntero a una estructura DISCDLGSTRUCT . La estructura especifica el comportamiento del intento de desconexión.

Valor devuelto

Si la función se realiza 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 valores siguientes.

Código devuelto	Descripción
ERROR_CANCELLED	Cuando el sistema solicita al usuario una decisión sobre la desconexión, el usuario ha elegido no desconectarse.
ERROR_OPEN_FILES	No se puede desconectar porque el usuario usa activamente la conexión.
ERROR_BUSY	El proveedor de red está ocupado (posiblemente inicializando). El autor de la llamada debe reintentar.
ERROR_NO_NETWORK	La red no está disponible.
ERROR_NOT_ENOUGH_MEMORY	No hay memoria suficiente para iniciar el cuadro de diálogo.
ERROR_EXTENDED_ERROR	Error específico de la red. Llame a la función WNetGetLastError para obtener una descripción del error.

Comentarios

Nota

El encabezado winnetwk.h define WNetDisconnectDialog1 como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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