Share via


IEnumUnknown::Next 方法 (objidl.h)

擷取列舉序列中指定的項目數目。

語法

HRESULT Next(
  [in]  ULONG    celt,
  [out] IUnknown **rgelt,
  [out] ULONG    *pceltFetched
);

參數

[in] celt

要擷取的項目數目。 如果序列中剩餘的項目數目少於所要求的項目數,這個方法會擷取其餘的專案。

[out] rgelt

列舉項目的陣列。

列舉值負責呼叫 AddRef,而呼叫端負責透過列舉的每個指標呼叫 Release 。 如果 celt 大於 1,呼叫端也必須傳遞傳遞至 pceltFetched 的非 NULL 指標,以瞭解要釋放的指標數目。

[out] pceltFetched

已擷取的項目數目。 此參數一律小於或等於所要求的項目數目。

傳回值

如果方法擷取所要求的項目數,傳回值會S_OK。 否則,它會S_FALSE。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 objidl.h (包含 ObjIdl.h)

另請參閱

IEnumUnknown

IUnknown