Поделиться через

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

  • Статья

[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 не поддерживается в Windows Vista и более поздних версиях.

Чтобы вызвать эту функцию, сначала вызовите функцию LoadLibrary для загрузки Mpr.dll. Затем вызовите функцию GetProcAddress , чтобы получить адрес функции WNetRestoreConnectionW .

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

Требования

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

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

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

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