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

Статья
11/20/2024

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

Синтаксис

typedef struct _DISCDLGSTRUCTW {
  DWORD  cbStructure;
  HWND   hwndOwner;
  LPWSTR lpLocalName;
  LPWSTR lpRemoteName;
  DWORD  dwFlags;
} DISCDLGSTRUCTW, *LPDISCDLGSTRUCTW;

Члены

cbStructure

Тип: DWORD

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

hwndOwner

Тип: HWND

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

lpLocalName

Тип: LPTSTR

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

lpRemoteName

Тип: LPTSTR

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

dwFlags

Тип: DWORD

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

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

Ценность

Значение

DISC_UPDATE_PROFILE

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

DISC_NO_FORCE

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

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

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	winnetwk.h

См. также

WNetDisconnectDialog1

Обзор сети Windows (WNet)

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

Поделиться через