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 |
|
| IDL |
|