Compartilhar via

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

  • Artigo

O método IWiaItem::GetRootItem recupera o item raiz de uma árvore de objetos de item usados para representar um dispositivo de hardware WIA (Aquisição de Imagens do Windows).

Sintaxe

HRESULT GetRootItem(
  [out] IWiaItem **ppIWiaItem
);

Parâmetros

[out] ppIWiaItem

Tipo: IWiaItem**

Recebe o endereço de um ponteiro para a interface IWiaItem que contém um ponteiro para a interface IWiaItem do item raiz.

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

Considerando qualquer objeto IWiaItem na árvore de objetos de um dispositivo de hardware WIA, o aplicativo recupera um ponteiro para o item raiz chamando essa função.

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