IEnumAgent::Next メソッド (tapi3.h)

  • [アーティクル]

Next メソッドは、列挙シーケンス内の次に指定された数の要素を取得します。

構文

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

パラメーター

[in] celt

要求された要素の数。

[out] ppElements

ITAgent ポインターへのポインター。

[out] pceltFetched

実際に指定された要素の数へのポインター。 celt が 1 の場合は NULL になることがあります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 説明
S_OK
 メソッドは、 要素のセル数を 返しました。
S_FALSE
 残りの要素の数が celt 未満でした。
E_POINTER
 ppElements パラメーターは有効なポインターではありません。
E_OUTOFMEMORY
 操作を実行するためのメモリが不足しています。

解説

TAPI は、IEnumAgent::Next によって返される ITAgent インターフェイスで AddRef メソッドを呼び出します。 アプリケーションは、ITAgent インターフェイスで Release を呼び出して、それに関連付けられているリソースを解放する必要があります。

要件

   
対象プラットフォーム Windows
ヘッダー tapi3.h (Tapi3.h を含む)
Library Uuid.lib
[DLL] Tapi3.dll

関連項目

IEnumAgent

ITAgent