Compartir a través de

Estructura DISCDLGSTRUCTA (winnetwk.h)

  • Artículo

La estructura DISCDLGSTRUCT se usa en la función WNetDisconnectDialog1 . La estructura contiene información necesaria para el intento de desconexión.

Sintaxis

typedef struct _DISCDLGSTRUCTA {
  DWORD cbStructure;
  HWND  hwndOwner;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  DWORD dwFlags;
} DISCDLGSTRUCTA, *LPDISCDLGSTRUCTA;

Miembros

cbStructure

Tipo: DWORD

Tamaño, en bytes, de la estructura DISCDLGSTRUCT . El autor de la llamada debe proporcionar este valor.

hwndOwner

Tipo: HWND

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

lpLocalName

Tipo: LPTSTR

Puntero a una cadena terminada en NULL que especifica el nombre del dispositivo local que se redirige al recurso de red, como "F:" o "LPT1".

lpRemoteName

Tipo: LPTSTR

Puntero a una cadena terminada en NULL que especifica el nombre del recurso de red que se va a desconectar. Este miembro puede ser NULL si se especifica el miembro lpLocalName . Cuando se especifica lpLocalName , se desconecta la conexión al recurso de red redirigido desde lpLocalName .

dwFlags

Tipo: DWORD

Conjunto de marcas de bits que describen la conexión. Este miembro puede ser una combinación de los valores siguientes.

Valor Significado
DISC_UPDATE_PROFILE
 Si se establece este valor, la conexión especificada ya no es persistente (se restaura automáticamente cada vez que el usuario inicia sesión). Esta marca solo es válida si el miembro lpLocalName especifica un dispositivo local.
DISC_NO_FORCE
 Si no se establece este valor, el sistema aplica fuerza al intentar desconectar del recurso de red.

Esta situación suele producirse cuando el usuario tiene archivos abiertos a través de la conexión. Este valor significa que se informará al usuario si hay archivos abiertos en la conexión y se le preguntará si desea desconectarlo. Si el usuario quiere continuar, el procedimiento de desconexión vuelve a intentarlo con fuerza adicional.

Comentarios

Nota

El encabezado winnetwk.h define DISCDLGSTRUCT 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

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado winnetwk.h

Consulte también

WNetDisconnectDialog1

Información general sobre redes de Windows (WNet)

Estructuras de redes de Windows