共用方式為


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