Método IWiaItem2::CreateChildItem

Crie um novo item filho. Adiciona objetos IWiaItem2 à árvore IWiaItem2 de um dispositivo.

Sintaxe

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

Parâmetros

lItemFlags [in]

Tipo: LONG

Especifica o tipo de item WIA 2.0. Consulte Sinalizadores de tipo de item WIA.

lCreationFlags [in]

Tipo: LONG

Especifica como criar o novo item.

0 (0)

Defina os valores padrão para as propriedades do filho.

COPY_PARENT_PROPERTY_VALUES (0x40000000)

Copie os valores de todas as propriedades de Leitura/Gravação do pai.

bstrItemName [in]

Tipo: BSTR

Especifica o nome do item. Esse nome é acrescentado ao final do nome do item pai para gerar o nome completo do item.

ppIWiaItem2 [out]

Tipo: IWiaItem2**

Recebe o endereço de um ponteiro para a interface IWiaItem2 que define o método IWiaItem2::CreateChildItem .

Valor retornado

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

Alguns dispositivos de hardware WIA 2.0 permitem que os aplicativos criem novos itens na árvore IWiaItem2 que representa o dispositivo. Os aplicativos devem testar os dispositivos para ver se dão suporte a essa funcionalidade. Use a interface IEnumWIA_DEV_CAPS para enumerar os recursos do dispositivo atual.

Se o dispositivo permitir a criação de novos itens na árvore IWiaItem2 , invocar IWiaItem2::CreateChildItem criará um novo objeto IWiaItem2 que é um filho do nó atual. Ele passa um ponteiro para o novo nó para o aplicativo por meio do parâmetro ppIWiaItem2 . Os aplicativos devem chamar o método IUnknown::Release nos ponteiros de interface que recebem por meio do parâmetro ppIWiaItem2 .

Se lCreationFlags for COPY_PARENT_PROPERTY_VALUES e lItemFlags for zero, a função retornará E_INVALIDARG.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	Wia.h
IDL	Wia.idl