IEnumAgent::Next 方法 (tapi3.h)

Next方法會取得列舉序列中下一個指定的專案數目。

語法

HRESULT Next(
  [in]  ULONG   celt,
  [out] ITAgent **ppElements,
  [out] ULONG   *pceltFetched
);

參數

[in] celt

要求的元素數目。

[out] ppElements

ITAgent指標的指標。

[out] pceltFetched

實際提供之元素數目的指標。 如果celt是 Null,可能是Null

傳回值

這個方法可以傳回其中一個值。

意義
S_OK
方法傳回 的元素 數目。
S_FALSE
剩餘的元素數目小於 celt
E_POINTER
ppElements參數不是有效的指標。
E_OUTOFMEMORY
記憶體不足,無法執行作業。

備註

TAPI 會在IEnumAgent::Next所傳回的 ITAgent介面上呼叫AddRef方法。 應用程式必須在ITAgent介面上呼叫Release,以釋放與其相關聯的資源。

需求

   
目標平台 Windows
標頭 tapi3.h (包含 Tapi3.h)
程式庫 Uuid.lib
Dll Tapi3.dll

另請參閱

IEnumAgent

ITAgent