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

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

構文

HRESULT Next(
  [in]      ULONG celt,
  [out]     BSTR  *ppStrings,
  [in, out] ULONG *pceltFetched
);

[in] celt

要求された要素の数。

[out] ppStrings

返される BSTR ポインターの一覧へのポインター。

[in, out] pceltFetched

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

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

リターンコード	説明
S_OK	メソッドは、要素のセル数を返しました。
S_FALSE	残りの要素の数が celt 未満でした。
E_POINTER	ppStrings パラメーターは有効なポインターではありません。

アプリケーションは SysFreeString を使用して 、ppStrings パラメーターに割り当てられたメモリを解放する必要があります。