Compartir a través de


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
RESOURCETYPE_DISK
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_EXTENDED_ERROR
Error específico de la red. Para obtener una descripción del error, llame a la función WNetGetLastError .
ERROR_INVALID_PASSWORD
La contraseña especificada no es válida.
ERROR_NO_NETWORK
La red no está disponible.
ERROR_NOT_ENOUGH_MEMORY
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

Consulte también

WNetAddConnection3

WNetCancelConnection2

WNetDisconnectDialog

Información general sobre redes de Windows (WNet)

Funciones de redes de Windows