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

Статья
08/27/2023

Функция WNetDisconnectDialog1 пытается отключить сетевой ресурс. Если базовая сеть возвращает ERROR_OPEN_FILES, функция запрашивает подтверждение у пользователя. При возникновении какой-либо ошибки функция информирует пользователя. Для этой функции требуется DISCDLGSTRUCT , чтобы указать параметры для попытки отключения.

Синтаксис

DWORD WNetDisconnectDialog1A(
  [in] LPDISCDLGSTRUCTA lpConnDlgStruct
);

Параметры

[in] lpConnDlgStruct

Указатель на структуру DISCDLGSTRUCT . Структура определяет поведение для попытки отключения.

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

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

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

Код возврата	Описание
ERROR_CANCELLED	Когда система запросила у пользователя решение об отключении, пользователь решил не отключаться.
ERROR_OPEN_FILES	Не удается отключиться, так как пользователь активно использует подключение.
ERROR_BUSY	Поставщик сети занят (возможно, инициализация). Вызывающий объект должен повторить попытку.
ERROR_NO_NETWORK	Сеть недоступна.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно памяти для запуска диалогового окна.
ERROR_EXTENDED_ERROR	Произошла ошибка, относявшаяся к сети. Вызовите функцию WNetGetLastError , чтобы получить описание ошибки.

Заголовок winnetwk.h определяет WNetDisconnectDialog1 в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


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