Estructura CONNECTDLGSTRUCTA (winnetwk.h)

La CONNECTDLGSTRUCT se usa en la función WNetConnectionDialog1 para establecer parámetros del cuadro de diálogo de exploración.

Sintaxis

typedef struct _CONNECTDLGSTRUCTA {
  DWORD          cbStructure;
  HWND           hwndOwner;
  LPNETRESOURCEA lpConnRes;
  DWORD          dwFlags;
  DWORD          dwDevNum;
} CONNECTDLGSTRUCTA, *LPCONNECTDLGSTRUCTA;

Miembros

cbStructure

Tipo: DWORD de

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

hwndOwner

Tipo: HWND

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

lpConnRes

Tipo: LPNETRESOURCE

Puntero a una estructura de NETRESOURCE.

Si se especifica el lpRemoteName miembro de NETRESOURCE, se escribirá en el campo de ruta de acceso del cuadro de diálogo. A excepción del miembro dwType de , todos los demás miembros de la estructura NETRESOURCE de deben establecerse en null. El miembro dwType debe ser igual a RESOURCETYPE_DISK.

El sistema no admite la marca RESOURCETYPE_PRINT para examinar y conectarse a recursos de impresión.

dwFlags

Tipo: DWORD de

Conjunto de marcas de bits que describen las opciones para la presentación del cuadro de diálogo. Este miembro puede ser una combinación de los valores siguientes.

Valor	Significado
sidTypeUser	La cuenta es una cuenta de usuario.
CONNDLG_RO_PATH	Mostrar una ruta de acceso de solo lectura en lugar de permitir que el usuario escriba una ruta de acceso. Esta marca solo se debe establecer si el miembro lpRemoteName del NETRESOURCE estructura apuntado por miembro lpConnRes no es null (o una cadena vacía) y no se establece la marca CONNDLG_USE_MRU.
CONNDLG_CONN_POINT	Marca interna. No use.
CONNDLG_USE_MRU	Escriba las rutas de acceso usadas más recientemente en el cuadro de combinación. Establezca este valor para simular la función WNetConnectionDialog.
CONNDLG_HIDE_BOX	Muestra la casilla que permite al usuario restaurar la conexión en el inicio de sesión.
CONNDLG_PERSIST	Restaure la conexión en el inicio de sesión.
CONNDLG_NOT_PERSIST	No restaure la conexión en el inicio de sesión.

 

Para obtener más información, vea la siguiente sección Comentarios.

dwDevNum

Tipo: DWORD de

Si la llamada a la función WNetConnectionDialog1 se realiza correctamente, este miembro devuelve el número del dispositivo conectado. El valor es 1 para A:, 2 para B:, 3 para C:, etc. Si el usuario realizó una conexión sin dispositivo, el valor es –1.

Observaciones

Si no se establece ni el CONNDLG_RO_PATH ni la marca de CONNDLG_USE_MRU y el lpRemoteName miembro de la estructura NETRESOURCE no especifica una ruta de acceso remota, la solicitud tiene como valor predeterminado el tipo de presentación del cuadro de diálogo de CONNDLG_RO_PATH.

Los valores CONNDLG_PERSIST y CONNDLG_NOT_PERSIST no se pueden establecer. Si no se establece ninguno, el cuadro de diálogo tiene como valor predeterminado la última opción seleccionada en este cuadro de diálogo para el tipo determinado de conexión de dispositivo.

Nota

El encabezado winnetwk.h define CONNECTDLGSTRUCT 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]
encabezado de	winnetwk.h

Consulte también

NETRESOURCE

WNetConnectionDialog1

redes de Windows (WNet)

estructuras de red de Windows