IEnumOleDocumentViews::Next 方法 (docobj.h)
擷取列舉序列中指定的項目數目。
語法
HRESULT Next(
[in] ULONG cViews,
[out] IOleDocumentView **rgpView,
[in, out] ULONG *pcFetched
);
參數
[in] cViews
要擷取的項目數。 如果序列中剩餘的項目數目少於所要求的項目數,這個方法會擷取其餘的專案。
如果 pcFetched 為 NULL,此參數必須為 1。
[out] rgpView
列舉項目的陣列。
列舉值負責呼叫 AddRef,而呼叫端負責透過列舉的每個指標呼叫 Release 。 如果 cViews 大於 1,呼叫端也必須傳遞傳遞至 pcFetched 的非 NULL 指標,以瞭解要釋放的指標數目。
[in, out] pcFetched
已擷取的項目數。 此參數一律小於或等於所要求的項目數目。 此參數可以是 NULL,在此情況下 ,cViews 參數必須是 1。
傳回值
如果方法擷取所要求的項目數,傳回值會S_OK。 否則,它會S_FALSE。
備註
E_NOTIMPL不允許作為傳回值。 如果傳回錯誤值, 則 rgpView 陣列中沒有任何專案有效,而且不需要呼叫 Release。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | docobj.h |