Структура DISCDLGSTRUCTA (winnetwk.h)

  • Статья

Структура DISCDLGSTRUCT используется в функции WNetDisconnectDialog1 . Структура содержит необходимые сведения для попытки отключения.

Синтаксис

typedef struct _DISCDLGSTRUCTA {
  DWORD cbStructure;
  HWND  hwndOwner;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  DWORD dwFlags;
} DISCDLGSTRUCTA, *LPDISCDLGSTRUCTA;

Члены

cbStructure

Тип: DWORD

Размер структуры DISCDLGSTRUCT (в байтах). Вызывающий объект должен предоставить это значение.

hwndOwner

Тип: HWND

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

lpLocalName

Тип: LPTSTR

Указатель на строку, завершающуюся значением NULL, которая указывает имя локального устройства, которое перенаправляется на сетевой ресурс, например "F:" или "LPT1".

lpRemoteName

Тип: LPTSTR

Указатель на строку, завершающуюся значением NULL, которая указывает имя сетевого ресурса для отключения. Этот элемент может иметь значение NULL, если указан элемент lpLocalName . Если указано значение lpLocalName , подключение к сетевому ресурсу, перенаправленное из lpLocalName , отключается.

dwFlags

Тип: DWORD

Набор битовых флагов, описывающих подключение. Этот элемент может быть сочетанием следующих значений.

Значение Значение
DISC_UPDATE_PROFILE
 Если это значение задано, указанное подключение больше не является постоянным (автоматически восстанавливается при каждом входе пользователя). Этот флаг действителен, только если элемент lpLocalName указывает локальное устройство.
DISC_NO_FORCE
 Если это значение не задано, система применяет принудительно при попытке отключиться от сетевого ресурса.

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

Комментарии

Примечание

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть winnetwk.h

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

WNetDisconnectDialog1

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

Сетевые структуры Windows