Función WNetConnectionDialog (winnetwk.h)

Artículo
03/08/2023

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