IVdsDisk::QueryExtents メソッド (vds.h)

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

ディスク上のすべてのエクステントの詳細を返します。

構文

HRESULT QueryExtents(
  [out] VDS_DISK_EXTENT **ppExtentArray,
  [out] LONG            *plNumberOfExtents
);

パラメーター

[out] ppExtentArray

を受け取るポインター変数
VDS_DISK_EXTENT構造体の配列。 呼び出し元は 、CoTaskMemFree 関数を使用してこの配列を解放する必要があります。

[out] plNumberOfExtents

エクステントの合計数を表す LONG 型のアドレス。

戻り値

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

リターン コード/値 説明
S_OK
エクステント情報が正常に返されました。
VDS_E_PACK_OFFLINE
0x80042444L
ディスクが属しているパックにアクセスできません。

注釈

ボリュームの作成または拡張に使用できる空き領域の量を確認するには、このメソッドを使用します。 エクステント情報を使用して、ディスクを占有するボリュームの数を決定することもできます。 有効なエクステント・タイプは、不明エクステント、フリー・エクステント、データ・エクステント、OEM エクステント、ESP エクステント、MSR エクステント、LDM メタデータ・エクステント、および使用不可エクステントです。 データエクステントには、その上にボリュームへのリンクが含まれています。

ディスクがダイナミック ディスクの場合は、オンラインである必要があります。 ベーシック ディスクまたは生ディスクの場合は、オンラインまたはオフラインにすることができます。

要件

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

こちらもご覧ください

IVdsDisk

IVdsDisk::ClearFlags

IVdsDisk::ConvertStyle

IVdsDisk::GetIdentificationData

IVdsDisk::GetPack

IVdsDisk::GetProperties

IVdsDisk::SetFlags

VDS_DISK_EXTENT