Función WNetConnectionDialog (winnetwk.h)
La función WNetConnectionDialog inicia un cuadro de diálogo de exploración general para conectarse a los recursos de red. La función requiere un identificador para la ventana de propietario del cuadro de diálogo.
Sintaxis
DWORD WNetConnectionDialog(
[in] HWND hwnd,
[in] DWORD dwType
);
Parámetros
[in] hwnd
Identificador de la ventana de propietario del cuadro de diálogo.
[in] dwType
Tipo de recurso para permitir conexiones. Este parámetro puede ser el siguiente valor.
| Valor | Significado |
|---|---|
|
Conexiones a recursos de disco. |
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es NO_ERROR. Si el usuario cancela el cuadro de diálogo, la función devuelve –1.
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 específico de la red. Para obtener una descripción del error, llame a la función WNetGetLastError . |
|
La contraseña especificada no es válida. |
|
La red no está disponible. |
|
No hay memoria suficiente para iniciar el cuadro de diálogo. |
Comentarios
Si el usuario hace clic en Aceptar en el cuadro de diálogo, se habrá realizado la conexión de red solicitada cuando se devuelva la función WNetConnectionDialog .
Si la función intenta realizar una conexión y el proveedor de red devuelve el mensaje ERROR_INVALID_PASSWORD, el sistema solicita al usuario que escriba una contraseña. El sistema usa la nueva contraseña en otro intento de realizar la conexió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 |