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

Статья
11/20/2024

Функция 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winnetwk.h
библиотеки	Mpr.lib
DLL	Mpr.dll