Estructura CONNECTDLGSTRUCTA (winnetwk.h)

La estructura CONNECTDLGSTRUCT la usa 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

Tamaño, en bytes, de la estructura CONNECTDLGSTRUCT . 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 NETRESOURCE .

Si se especifica el miembro lpRemoteName de NETRESOURCE , se escribirá en el campo de ruta de acceso del cuadro de diálogo. A excepción del miembro dwType , todos los demás miembros de la estructura NETRESOURCE 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 los recursos de impresión.

dwFlags

Tipo: DWORD

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 debe establecerse si el miembro lpRemoteName de la estructura NETRESOURCE a la que apunta el miembro lpConnRes no es NULL (o una cadena vacía) y no se establece la marca de CONNDLG_USE_MRU .
CONNDLG_CONN_POINT	Marca interna. No debe usarse.
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	Mostrar 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 sección Comentarios que se muestra más adelante.

dwDevNum

Tipo: DWORD

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.

Comentarios

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

Los valores de 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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

NETRESOURCE

WNetConnectionDialog1

Información general sobre redes de Windows (WNet)

Estructuras de redes de Windows