Metodo IWiaItem2::EnumChildItems

Crea un oggetto enumeratore e passa un puntatore alla relativa interfaccia IEnumWiaItem2 per le cartelle con elementi nell'albero IWiaItem2 di un dispositivo Windows Image Acquisition (WIA) 2.0.

Sintassi

HRESULT EnumChildItems(
  [in]  const GUID          *pCategoryGUID,
  [out]       IEnumWiaItem2 **ppIEnumWiaItem2
);

Parametri

pCategoryGUID [in]

Tipo: GUID const*

Specifica un puntatore a una categoria per cui vengono enumerati i nodi figlio. Se NULL, tutti i nodi figlio vengono enumerati.

ppIEnumWiaItem2 [out]

Tipo: IEnumWiaItem2**

Riceve l'indirizzo di un puntatore all'interfaccia IEnumWiaItem2 creata da questo metodo.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il sistema di runtime WIA 2.0 rappresenta ogni dispositivo hardware WIA 2.0 come albero gerarchico degli oggetti IWiaItem2 . Il metodo IWiaItem2::EnumChildItems consente alle applicazioni di enumerare gli elementi figlio nell'elemento corrente. Tuttavia, può essere applicato solo agli elementi che sono cartelle.

Se la cartella non è vuota, contiene un sottoalbero di oggetti IWiaItem2 . Il metodo IWiaItem2::EnumChildItems enumera tutti gli elementi contenuti nella cartella. Archivia un puntatore a un enumeratore nel parametro ppIEnumWiaItem2 . Le applicazioni usano il puntatore dell'enumeratore per eseguire l'enumerazione degli elementi figlio di un oggetto.

Le applicazioni devono chiamare il metodo IUnknown::Release nei puntatori di interfaccia ricevuti tramite il parametro ppIEnumWiaItem2 .

Requisiti