IEnumAddress::Next メソッド (tapi3if.h)

Next メソッドは、列挙シーケンス内の次に指定された数の要素を取得します。このメソッドは、Visual Basic およびスクリプト言語では非表示になっています。

構文

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

[in] celt

要求された要素の数。

[out] ppElements

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

[out] pceltFetched

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

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

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

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