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

[アーティクル]
03/08/2023

[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