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


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

Функция WNetConnectionDialog запускает общее диалоговое окно просмотра для подключения к сетевым ресурсам. Функции требуется дескриптор для окна владельца диалогового окна.

Синтаксис

DWORD WNetConnectionDialog(
  [in] HWND  hwnd,
  [in] DWORD dwType
);

Параметры

[in] hwnd

Обработка окна-владельца диалогового окна.

[in] dwType

Тип ресурса, к который нужно разрешить подключения. Этот параметр может иметь следующее значение.

Значение Значение
RESOURCETYPE_DISK
Подключения к ресурсам диска.

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

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

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

Код возврата Описание
ERROR_EXTENDED_ERROR
Произошла ошибка, относявшаяся к сети. Чтобы получить описание ошибки, вызовите функцию WNetGetLastError .
ERROR_INVALID_PASSWORD
Указанный пароль недопустим.
ERROR_NO_NETWORK
Сеть недоступна.
ERROR_NOT_ENOUGH_MEMORY
Недостаточно памяти для запуска диалогового окна.

Комментарии

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

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

Требования

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

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

WNetAddConnection3

WNetCancelConnection2

WNetDisconnectDialog

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

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