Compartilhar via

Método IWiaItem::CreateChildItem (wia_xp.h)

  • Artigo

O método IWiaItem::CreateChildItem é usado por aplicativos para adicionar objetos IWiaItem à árvore IWiaItem de um dispositivo.

Sintaxe

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

Parâmetros

[in] lFlags

Tipo: LONG

Especifica o tipo de item WIA. Deve ser definido como um dos valores listados em Sinalizadores de Tipo de Item WIA.

[in] bstrItemName

Tipo: BSTR

Especifica o nome do item WIA, como "Top". Você pode considerar esse parâmetro como equivalente a um nome de arquivo.

[in] bstrFullItemName

Tipo: BSTR

Especifica o nome completo do item WIA. Você pode considerar esse parâmetro como equivalente a um caminho completo para um arquivo, como "003\Root\Top".

[out] ppIWiaItem

Tipo: IWiaItem**

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

Retornar valor

Tipo: HRESULT

Se o 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 permitem que os aplicativos criem novos itens na árvore IWiaItem 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 IWiaItem , invocar IWiaItem::CreateChildItem criará um novo IWiaItem que é um filho do nó atual. IWiaItem::CreateChildItem passa um ponteiro para o novo nó para o aplicativo por meio do parâmetro ppIWiaItem .

Os aplicativos devem chamar o método IUnknown::Release nos ponteiros de interface que recebem por meio do parâmetro ppIWiaItem .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wia_xp.h (inclua Wia.h)
Biblioteca Wiaguid.lib
DLL Wiaservc.dll