Función WNetConnectionDialog1A (winnetwk.h)

Artículo
08/27/2023

La función WNetConnectionDialog1 abre un cuadro de diálogo de exploración general para conectarse a los recursos de red. La función requiere CONNECTDLGSTRUCT para establecer los parámetros del cuadro de diálogo.

Sintaxis

DWORD WNetConnectionDialog1A(
  [in, out] LPCONNECTDLGSTRUCTA lpConnDlgStruct
);

Parámetros

[in, out] lpConnDlgStruct

Puntero a una estructura CONNECTDLGSTRUCT . La estructura establece los parámetros del cuadro de diálogo de exploración.

Valor devuelto

Si el usuario cancela el cuadro de diálogo, la función devuelve –1. Si la función se realiza correctamente, devuelve NO_ERROR. Además, si la llamada se realiza correctamente, el miembro dwDevNum de la estructura CONNECTDLGSTRUCT contiene el número del dispositivo conectado.

Normalmente, este cuadro de diálogo devuelve un error solo si el usuario no puede escribir una sesión de diálogo. Esto se debe a que los errores que se producen después de una sesión de diálogo se notifican al usuario directamente. 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_INVALID_PARAMETER	Se establecen las opciones del cuadro de diálogo CONNDLG_RO_PATH y CONNDLG_USE_MRU. (Las opciones del cuadro de diálogo se especifican mediante el miembro dwFlags de la estructura CONNECTDLGSTRUCT ). O bien Se establecen las opciones CONNDLG_PERSIST y CONNDLG_NOT_PERSIST cuadro de diálogo. O bien La opción del cuadro de diálogo CONNDLG_RO_PATH se establece y el miembro lpRemoteName de la estructura NETRESOURCE no apunta a una red remota. (La estructura CONNECTDLGSTRUCT apunta a una estructura NETRESOURCE ).
ERROR_BAD_DEV_TYPE	El miembro dwType de la estructura NETRESOURCE no se establece en RESOURCETYPE_DISK.
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 mostrar el cuadro de diálogo.
ERROR_EXTENDED_ERROR	Error específico de la red. Llame a WNetGetLastError para obtener una descripción del error.

Comentarios

Nota

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