Función WNetRestoreConnectionW (winnetwk.h)

  • Artículo

[WNetRestoreConnectionW no está disponible para su uso en Windows Vista.]

La función WNetRestoreConnectionW restaura la conexión a un recurso de red. La función solicita al usuario, si es necesario, un nombre y una contraseña.

Sintaxis

DWORD WNetRestoreConnectionW(
  [in] HWND    hWnd,
  [in] LPCWSTR lpDevice
);

Parámetros

[in] hWnd

Identificador de la ventana primaria que usa la función para mostrar la interfaz de usuario (UI) que solicita al usuario un nombre y una contraseña al realizar la conexión de red. Si este parámetro es NULL, no hay ninguna ventana de propietario.

[in] lpDevice

Puntero a una cadena Unicode terminada en null que especifica el nombre local de la unidad a la que se va a conectar, como "Z:". Si este parámetro es NULL, la función vuelve a conectar todas las unidades persistentes almacenadas en el Registro para el usuario actual.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NO_ERROR.

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_ACCESS_DENIED
 El autor de la llamada no tiene acceso al recurso de red.
ERROR_ALREADY_ASSIGNED
 El dispositivo local especificado por lpDevice ya está conectado a un recurso de red.
ERROR_BAD_DEV_TYPE
 El tipo de dispositivo local y el tipo de recurso de red no coinciden.
ERROR_BAD_DEVICE
 El valor especificado por lpDevice no es válido.
ERROR_BAD_PROFILE
 El perfil de usuario tiene un formato incorrecto.
ERROR_BUSY
 El enrutador o proveedor está ocupado, posiblemente inicializando. El autor de la llamada debe reintentar.
ERROR_CANCELLED
 El usuario canceló el intento de realizar la conexión a través de un cuadro de diálogo de uno de los proveedores de recursos de red o mediante un recurso llamado.
ERROR_CANNOT_OPEN_PROFILE
 El sistema no puede abrir el perfil de usuario para procesar conexiones persistentes.
ERROR_DEVICE_ALREADY_REMEMBERED
 Ya hay una entrada para el dispositivo en el perfil de usuario.
ERROR_EXTENDED_ERROR
 Error específico de la red. Llame a la función WNetGetLastError para obtener una descripción del error.
ERROR_INVALID_PASSWORD
 La contraseña especificada no es válida.
ERROR_NO_NET_OR_BAD_PATH
 No se puede realizar la operación porque no se inicia un componente de red o porque no se puede usar un nombre especificado.
ERROR_NO_NETWORK
 La red no está disponible.

Comentarios

La función WNetRestoreConnectionW no se admite en Windows Vista ni versiones posteriores.

Para llamar a esta función, primero llame a la función LoadLibrary para cargar Mpr.dll. A continuación, llame a la función GetProcAddress para recuperar la dirección de la función WNetRestoreConnectionW .

Winlogon usa WNetRestoreConnectionW para restaurar todas las asignaciones de unidades persistentes durante el proceso de inicio de sesión interactivo. Microsoft Windows Shell también llama a la función para volver a conectar unidades individuales a la solicitud del usuario. Esto puede ocurrir, por ejemplo, cuando una unidad no se puede volver a conectar al iniciar sesión y el usuario hace doble clic en la unidad en la carpeta virtual Mi equipo.

Requisitos

Requisito Value
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

Información general sobre redes de Windows (WNet)

Funciones de redes de Windows