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

Статья
08/27/2023

Функция 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	Недостаточно памяти для запуска диалогового окна.

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

Требования


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