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