Compartir a través de


Función WNetDisconnectDialog1A (winnetwk.h)

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 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 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 está usando 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.

Observaciones

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 Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de winnetwk.h
biblioteca de Mpr.lib
DLL de Mpr.dll

Consulte también

DISCDLGSTRUCT

WNetConnectionDialog

WNetConnectionDialog1

WNetDisconnectDialog

redes de Windows (WNet)

funciones de red de Windows