Функция WNetRestoreConnectionW (winnetwk.h)

Статья
03/08/2023

[WNetRestoreConnectionW недоступен для использования в Windows Vista.]

Функция WNetRestoreConnectionW восстанавливает подключение к сетевому ресурсу. Функция при необходимости запрашивает у пользователя имя и пароль.

Синтаксис

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

Параметры

[in] hWnd

Дескриптор родительского окна, которое функция использует для отображения пользовательского интерфейса, который запрашивает у пользователя имя и пароль при подключении к сети. Если этот параметр имеет значение NULL, окно владельца отсутствует.

[in] lpDevice

Указатель на строку Юникода, завершающуюся null, которая указывает локальное имя диска для подключения, например Z:. Если этот параметр имеет значение NULL, функция повторно подключает все постоянные диски, хранящиеся в реестре, для текущего пользователя.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращаемое значение представляет собой системный код ошибки, например одно из следующих значений.

Код возврата	Описание
ERROR_ACCESS_DENIED	Вызывающий объект не имеет доступа к сетевому ресурсу.
ERROR_ALREADY_ASSIGNED	Локальное устройство, указанное в lpDevice , уже подключено к сетевому ресурсу.
ERROR_BAD_DEV_TYPE	Тип локального устройства и тип сетевого ресурса не совпадают.
ERROR_BAD_DEVICE	Недопустимое значение, заданное lpDevice .
ERROR_BAD_PROFILE	Профиль пользователя имеет неправильный формат.
ERROR_BUSY	Маршрутизатор или поставщик занят, возможно, инициализируется. Вызывающий объект должен повторить попытку.
ERROR_CANCELLED	Попытка установить подключение была отменена пользователем с помощью диалогового окна одного из поставщиков сетевых ресурсов или вызываемого ресурса.
ERROR_CANNOT_OPEN_PROFILE	Системе не удается открыть профиль пользователя для обработки постоянных подключений.
ERROR_DEVICE_ALREADY_REMEMBERED	Запись для устройства уже находится в профиле пользователя.
ERROR_EXTENDED_ERROR	Произошла ошибка, относявшаяся к сети. Вызовите функцию WNetGetLastError , чтобы получить описание ошибки.
ERROR_INVALID_PASSWORD	Указанный пароль недопустим.
ERROR_NO_NET_OR_BAD_PATH	Невозможно выполнить операцию, так как не запущен сетевой компонент или невозможно использовать указанное имя.
ERROR_NO_NETWORK	Сеть недоступна.

WNetRestoreConnectionW используется Winlogon для восстановления всех сопоставлений постоянных дисков во время интерактивного входа в систему. Функция также вызывается оболочкой Microsoft Windows для повторного подключения отдельных дисков по запросу пользователя. Это может произойти, например, когда диск не удается повторно подключиться при входе в систему и пользователь дважды щелкает диск в виртуальной папке "Мой компьютер".

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winnetwk.h
Библиотека	Mpr.lib
DLL	Mpr.dll

См. также раздел

Общие сведения о сети Windows (WNet)

Сетевые функции Windows