Структура DEVICEDIALOGDATA2

Определяет данные, необходимые для вызова диалогового окна устройства.

Синтаксис

typedef struct {
  DWORD     cbSize;
  IWiaItem2 *pIWiaItemRoot;
  DWORD     dwFlags;
  HWND      hwndParent;
  BSTR      bstrFolderName;
  BSTR      bstrFilename;
  LONG      lNumFiles;
  BSTR      *pbstrFilePaths;
  IWiaItem2 *ppWiaItem;
} DEVICEDIALOGDATA2;

Члены

cbSize

Тип: DWORD

Задает размер этой структуры в байтах.

pIWiaItemRoot

Тип: IWiaItem2*

Указывает на интерфейс IWiaItem2 , представляющий допустимый корневой элемент в дереве элементов приложения.

dwFlags

Тип: DWORD

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

Flag	Значение
0	Поведение по умолчанию.
WIA_DEVICE_DIALOG_SINGLE_IMAGE	Ограничьте выбор изображения одним изображением в диалоговом окне получения образа устройства.
WIA_DEVICE_DIALOG_USE_COMMON_UI	Используйте системный пользовательский интерфейс , если он доступен, а не предоставленный поставщиком пользовательский интерфейс. Если пользовательский интерфейс системы недоступен, используется пользовательский интерфейс поставщика. Если пользовательский интерфейс недоступен, функция возвращает E_NOTIMPL.

 

hwndParent

Тип: HWND

Указывает дескриптор родительского окна диалогового окна.

bstrFolderName

Тип: BSTR

Указывает имя папки, в которой передаются файлы.

bstrFilename

Тип: BSTR

Указывает шаблон имени файла, который будет использоваться для файлов, передаваемых из элементов WIA в целевую папку, назначенную bstrFolderName. Можно создать произвольное количество уникальных имен файлов, добавив дополнительные символы в шаблон имени файла.

lNumFiles

Тип: LONG

Получает количество строк, записанных в массив pbstrFilePaths .

pbstrFilePaths

Тип: BSTR*

Указатель на массив указателей BSTR. Каждый элемент массива указывает на BSTR, содержащий имя назначения файла, который был успешно передан в папку, определяемую bstrFolderName. Метод должен выделить хранилище для этого элемента.

ppWiaItem

Тип: IWiaItem2*

Указатель на интерфейс IWiaItem2 элемента WIA, который передает данные в файл или файлы с именем в массиве pbstrFilePaths .

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Заголовок	Wiadefd.h