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

Метод IWiaItem::CreateChildItem (wia_xp.h)

  • Статья

Метод IWiaItem::CreateChildItem используется приложениями для добавления объектов IWiaItem в дерево IWiaItem устройства.

Синтаксис

HRESULT CreateChildItem(
  [in]  LONG     lFlags,
  [in]  BSTR     bstrItemName,
  [in]  BSTR     bstrFullItemName,
  [out] IWiaItem **ppIWiaItem
);

Параметры

[in] lFlags

Тип: LONG

Указывает тип элемента WIA. Для параметра должно быть задано одно из значений, перечисленных в разделе Флаги типов элементов WIA.

[in] bstrItemName

Тип: BSTR

Указывает имя элемента WIA, например "Top". Этот параметр можно считать эквивалентным имени файла.

[in] bstrFullItemName

Тип: BSTR

Указывает полное имя элемента WIA. Этот параметр можно рассматривать как эквивалент полного пути к файлу, например "003\Root\Top".

[out] ppIWiaItem

Тип: IWiaItem**

Получает адрес указателя на интерфейс IWiaItem , который задает метод IWiaItem::CreateChildItem .

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

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

Если устройство позволяет создавать новые элементы в дереве IWiaItem , вызов IWiaItem::CreateChildItem создает новый элемент IWiaItem , который является дочерним элементом текущего узла. IWiaItem::CreateChildItem передает в приложение указатель на новый узел с помощью параметра ppIWiaItem .

Приложения должны вызывать метод IUnknown::Release для указателей интерфейса, которые они получают через параметр ppIWiaItem .

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header wia_xp.h (включая Wia.h)
Библиотека Wiaguid.lib
DLL Wiaservc.dll