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

Метод IWiaItem2::CreateChildItem

  • Статья

Создайте новый дочерний элемент. Добавляет объекты IWiaItem2 в дерево IWiaItem2 устройства.

Синтаксис

HRESULT CreateChildItem(
  [in]  LONG      lItemFlags,
  [in]  LONG      lCreationFlags,
  [in]  BSTR      bstrItemName,
  [out] IWiaItem2 **ppIWiaItem2
);

Параметры

lItemFlags [in]

Тип: LONG

Указывает тип элемента WIA 2.0. См. раздел Флаги типов элементов WIA.

lCreationFlags [in]

Тип: LONG

Указывает способ создания нового элемента.

0 (0)

Задайте значения по умолчанию для свойств дочернего элемента.

COPY_PARENT_PROPERTY_VALUES (0x40000000)

Скопируйте значения всех свойств чтения и записи из родительского элемента.

bstrItemName [in]

Тип: BSTR

Указывает имя элемента. Это имя добавляется в конец имени родительского элемента, чтобы создать полное имя элемента.

ppIWiaItem2 [out]

Тип: IWiaItem2**

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

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

Тип: HRESULT

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

Комментарии

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

Если устройство позволяет создавать новые элементы в дереве IWiaItem2 , вызов IWiaItem2::CreateChildItem создает новый объект IWiaItem2 , который является дочерним для текущего узла. Он передает указатель на новый узел в приложение с помощью параметра ppIWiaItem2 . Приложения должны вызывать метод IUnknown::Release для указателей интерфейса, которые они получают через параметр ppIWiaItem2 .

Если значение lCreationFlags равно COPY_PARENT_PROPERTY_VALUES, а lItemFlags равно нулю, функция возвращает E_INVALIDARG.

Требования

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