Next メソッドは、列挙シーケンス内の次に指定された数の要素を取得します。
構文
HRESULT Next(
[in] ULONG celt,
[out] ITAgentHandler **ppElements,
[out] ULONG *pceltFetched
);
パラメーター
[in] celt
要求された要素の数。
[out] ppElements
ITAgentHandler インターフェイスへのポインター。
[out] pceltFetched
実際に指定された要素の数へのポインター。 celt が 1 の場合は NULL になることがあります。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| 値 | 意味 |
|---|---|
|
メソッドは、 要素のセル数を 返しました。 |
|
残りの要素の数が celt 未満でした。 |
|
ppElements パラメーターは有効なポインターではありません。 |
|
操作を実行するためのメモリが不足しています。 |
注釈
TAPI は、IEnumAgentHandler::Next によって返される IEnumAgentHandler インターフェイスで AddRef メソッドを呼び出します。 アプリケーションは、関連付けられているリソースを解放するために、IEnumAgentHandler インターフェイスで Release を呼び出す必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tapi3.h (Tapi3.h を含む) |
| Library | Uuid.lib |
| [DLL] | Tapi3.dll |