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
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista [solo app desktop] |
| Server minimo supportato |
Windows Server 2008 [solo app desktop] |
| Intestazione |
|
| IDL |
|