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

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

  • Статья

Структура CONNECTDLGSTRUCT используется функцией WNetConnectionDialog1 для установки параметров диалогового окна просмотра.

Синтаксис

typedef struct _CONNECTDLGSTRUCTA {
  DWORD          cbStructure;
  HWND           hwndOwner;
  LPNETRESOURCEA lpConnRes;
  DWORD          dwFlags;
  DWORD          dwDevNum;
} CONNECTDLGSTRUCTA, *LPCONNECTDLGSTRUCTA;

Члены

cbStructure

Тип: DWORD

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

hwndOwner

Тип: HWND

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

lpConnRes

Тип: LPNETRESOURCE

Указатель на структуру NETRESOURCE.

Если указан элемент lpRemoteName NETRESOURCE, он будет введен в поле пути диалогового окна. За исключением элемента dwType dwType, все остальные члены структуры NETRESOURCE должны иметь значение NULL. Элемент dwType должен быть равен RESOURCETYPE_DISK.

Система не поддерживает флаг RESOURCETYPE_PRINT для просмотра и подключения к ресурсам печати.

dwFlags

Тип: DWORD

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

Ценность Значение
SidTypeUser
 Учетная запись — это учетная запись пользователя.
CONNDLG_RO_PATH
 Отображение пути только для чтения вместо того, чтобы разрешить пользователю вводить путь.

Этот флаг следует задать, только если элемент lpRemoteName структуры NETRE SOURCE, на которую указывает элемент lpConnRes не NULL (или пустая строка), а флаг CONNDLG_USE_MRU не задан.
CONNDLG_CONN_POINT
 Внутренний флаг. Не используйте.
CONNDLG_USE_MRU
 Введите последние используемые пути в поле сочетания. Задайте это значение, чтобы имитировать функцию WNetConnectionDialog.
CONNDLG_HIDE_BOX
 Установите флажок, позволяющий пользователю восстановить подключение при входе.
CONNDLG_PERSIST
 Восстановите подключение при входе.
CONNDLG_NOT_PERSIST
 Не восстанавливайте подключение при входе.
 

Дополнительные сведения см. в следующем разделе "Примечания".

dwDevNum

Тип: DWORD

Если вызов функции WNetConnectionDialog1 выполнен успешно, этот элемент возвращает номер подключенного устройства. Значение равно 1 для A:, 2 для B:, 3 для C:, и т. д. Если пользователь сделал подключение без устройства, значение равно –1.

Замечания

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

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

Заметка

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

Требования

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

См. также

NETRESOURCE

WNetConnectionDialog1

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

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