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

Статья
27.08.2023

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

Синтаксис

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

Параметры

[in] hwnd

Дескриптор окна владельца диалогового окна.

[in] dwType

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

Значение	Значение
RESOURCETYPE_DISK	Отключается от дисковых ресурсов.

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

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

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

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

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

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

Требования


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