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 プロバイダー から発生する可能性があります。 可能な戻り値は次のとおりです。
リターン コード | 説明 |
---|---|
|
メソッドは、指定した数のオブジェクトを返しました。 pcFetched で報告された返されるオブジェクトの数は celt と等しくなります。は、これらのオブジェクトを返します。 |
|
返されるオブジェクトの指定された数が、残りのオブジェクトの数を超えています。 残りのすべてのオブジェクトが返され、返されたオブジェクトの数がセルよりも小さい pcFetched で報告されます。は、これらのオブジェクトを返します。 |
注釈
ppObjectArray 配列で返される IUnknown ポインターからオブジェクト固有のインターフェイス ポインターを取得するには、IUnknown::QueryInterface メソッドを使用します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | vdshwprv.h |
Library | Uuid.lib |