IEnumWiaItem2::Next 方法
填入 IWiaItem2 介面的指標陣列。
語法
HRESULT Next(
[in] ULONG cElt,
[out] IWiaItem2 **ppIWiaItem2,
[in, out] ULONG *pcEltFetched
);
參數
-
cElt [in]
-
類型: ULONG
指定 ppIWiaItem2 參數所指示之陣列中的陣列元素數目。
-
ppIWiaItem2 [out]
-
類型: IWiaItem2**
接收 IWiaItem2 介面指標陣列的位址。 IEnumWiaItem2::Next 會以介面指標填入此陣列。
-
pcEltFetched [in, out]
-
類型: ULONG*
在輸出時,此參數會接收實際儲存在 ppIWiaItem2 參數所指示之陣列中的介面指標數目。 當列舉完成時,此參數會包含零。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
Windows Image Acquisition (WIA) 2.0 執行時間系統將 WIA 2.0 硬體裝置表示為 IWiaItem2 物件的階層式樹狀結構。 應用程式會使用 IEnumWiaItem2::Next 方法來取得硬體裝置 IWiaItem2 物件樹狀結構目前資料夾中每個專案的 IWiaItem2 介面指標。
若要取得指標清單,應用程式會傳遞它所配置的 IWiaItem2 介面指標陣列。 它也會傳遞 參數 cElt中的陣列元素數目。 IEnumWiaItem2::Next方法會以IWiaItem2介面的指標填入陣列。
在列舉程式完成之前, IEnumWiaItem2::Next 方法會傳回S_OK。 每次執行時,都會將 pcEltFetched 所指向的值設定為插入陣列中的專案數。 當 IEnumWiaItem2::Next完成列舉IWiaItem2物件的程式時,它會傳回S_FALSE,並將pcEltFetched指向的記憶體位置設定為零。
應用程式必須在透過ppIWiaItem2參數收到的介面指標上呼叫IUnknown::Release方法。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2008 [僅限傳統型應用程式] |
標頭 |
|
Idl |
|