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

[Windows 8とWindows Server 2012以降、仮想ディスク サービス COM インターフェイスは Windows Storage Management API に置き換えられます。

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

構文

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

パラメーター

[in] celt

返すオブジェクトの数。

[out] ppObjectArray

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

[out] pcFetched

PPObjectArray 内のオブジェクトの数に戻って VDS が初期化する ULONG のアドレス。

戻り値

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

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

注釈

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

要件

要件
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー vdshwprv.h
Library Uuid.lib

こちらもご覧ください

IEnumVdsObject