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

Структура 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 .

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

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

dwFlags

Тип: DWORD

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

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

Этот флаг следует устанавливать только в том случае, если элемент lpRemoteName структуры NETRESOURCE , на который указывает элемент 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 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть winnetwk.h

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

NETRESOURCE

WNetConnectionDialog1

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

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