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 [僅限傳統型應用程式] |
標頭 |
|
Idl |
|