Metodo IWiaItem::EnumChildItems (wia_xp.h)

Articolo
08/27/2023

Il metodo IWiaItem::EnumChildItems crea un oggetto enumeratore e passa un puntatore alla relativa interfaccia IEnumWiaItem per cartelle non vuote in un albero IWiaItem di un dispositivo Windows Image Acquisition (WIA).

Sintassi

HRESULT EnumChildItems(
  [out] IEnumWiaItem **ppIEnumWiaItem
);

Parametri

[out] ppIEnumWiaItem

Tipo: IEnumWiaItem**

Riceve l'indirizzo di un puntatore all'interfaccia IEnumWiaItem creata da IWiaItem::EnumChildItems .

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 rappresenta ogni dispositivo hardware WIA come albero gerarchico degli oggetti IWiaItem . Il metodo IWiaItem::EnumChildItems consente alle applicazioni di enumerare 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 IWiaItem . Il metodo IWiaItem::EnumChildItems enumera tutti gli elementi contenuti nella cartella. Archivia un puntatore a un enumeratore nel parametro ppIEnumWiaItem . 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 ppIEnumWiaItem .

Requisiti


Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wia_xp.h (includere Wia.h)
Libreria	Wiaguid.lib
DLL	Wiaservc.dll

Condividi tramite