Función WNetConnectionDialog1A (winnetwk.h)
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 de 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 ejecuta correctamente, devuelve NO_ERROR. Además, si la llamada se realiza correctamente, el dwDevNum miembro del CONNECTDLGSTRUCT estructura 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 que una sesión de diálogo se notifiquen directamente al usuario. 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 |
|---|---|
|
Se establecen tanto el CONNDLG_RO_PATH como las opciones del cuadro de diálogo de CONNDLG_USE_MRU. (Las opciones del cuadro de diálogo se especifican mediante el miembro dwFlags de la estructura CONNECTDLGSTRUCT). -o- Se establecen las opciones de CONNDLG_PERSIST y CONNDLG_NOT_PERSIST cuadro de diálogo. -o- Se establece la opción de cuadro de diálogo CONNDLG_RO_PATH y el miembro lpRemoteName de la estructura de NETRESOURCE no apunta a una red remota. (La estructura de CONNECTDLGSTRUCT de |
|
El miembro dwType de la estructura de NETRESOURCE no está establecido en RESOURCETYPE_DISK. |
|
El proveedor de red está ocupado (posiblemente inicializando). El autor de la llamada debe reintentar. |
|
La red no está disponible. |
|
No hay memoria suficiente para mostrar el cuadro de diálogo. |
|
Error específico de la red. Llame a WNetGetLastError para obtener una descripción del error. |
Observaciones
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 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 |