IEnumVdsObject::Next メソッド (vds.h)

[Windows 8とWindows Server 2012以降、Virtual Disk Service COM インターフェイスは Windows Storage Management API に置き換えられます。

現在のポイントから始まる、列挙体内の指定した数のオブジェクトを返します。詳細については、「列挙オブジェクトの操作」を参照してください。

構文

HRESULT Next(
  [in]  ULONG    celt,
  [out] IUnknown **ppObjectArray,
  [out] ULONG    *pcFetched
);

[in] celt

返すオブジェクトの数。

[out] ppObjectArray

戻り値の際に VDS が初期化する IUnknown ポインターの配列のアドレス。

[out] pcFetched

ULONG のアドレス。VDS がで初期化すると、ppObjectArray 内のオブジェクトの数に戻ります。

このメソッドは、E_INVALIDARGやE_OUTOFMEMORYなどの標準の HRESULT 値と、VDS 固有の戻り値を返すことができます。また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステムエラーコードを返すこともできます。エラーは、VDS 自体または使用されている基になる VDS プロバイダーから発生する可能性があります。可能な戻り値は次のとおりです。

リターンコード	説明
S_OK	メソッドは、指定した数のオブジェクトを返しました。 pcFetched で報告された返されるオブジェクトの数は celt と等しくなります。は、これらのオブジェクトを返します。
S_FALSE	返されるオブジェクトの指定された数が、残りのオブジェクトの数を超えています。残りのすべてのオブジェクトが返され、返されたオブジェクトの数がセルト未満である pcFetched で報告されます。は、これらのオブジェクトを返します。

ppObjectArray 配列で返される IUnknown ポインターからオブジェクト固有のインターフェイスポインターを取得するには、IUnknown::QueryInterface メソッドを使用します。