IWiaItem2::EnumChildItems 方法

建立列舉值物件,並將指標傳回其 IEnumWiaItem2 介面,以取得 Windows Image Acquisition (WIA) 2.0 裝置之 IWiaItem2 樹狀目錄中的專案。

語法

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

參數

pCategoryGUID [in]

類型: const GUID*

指定列舉子節點之類別的指標。 如果 為 Null,則會列舉所有子節點。

ppIEnumWiaItem2 [out]

類型: IEnumWiaItem2**

接收這個方法所建立 之 IEnumWiaItem2 介面的指標位址。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

WIA 2.0 執行時間系統會將每個 WIA 2.0 硬體裝置表示為 IWiaItem2 物件的階層式樹狀結構。 IWiaItem2::EnumChildItems方法可讓應用程式列舉目前專案中的子專案。 不過,它只能套用至資料夾的專案。

如果資料夾不是空的,它會包含 IWiaItem2 物件的子樹。 IWiaItem2::EnumChildItems方法會列舉資料夾中包含的所有專案。 它會將列舉值的指標儲存在 ppIEnumWiaItem2 參數中。 應用程式會使用列舉值指標來執行物件的子專案列舉。

應用程式必須在透過ppIEnumWiaItem2參數收到的介面指標上呼叫IUnknown::Release方法。

規格需求

需求
最低支援的用戶端
Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2008 [僅限傳統型應用程式]
標頭
Wia.h
Idl
Wia.idl