MSFT_StoragePool クラスの GetSupportedSize メソッド

ストレージ プールに作成できるサポートされている仮想ディスク サイズを取得します。

これらのサイズは、次のいずれかの方法または両方の方法で返されることがあります。

  • SupportedSizes パラメーターで、サポートされているすべてのサイズの配列として。
  • VirtualDiskSizeMinVirtualDiskSizeMax、および VirtualDiskSizeDivisor パラメーターによって定義された範囲として。

構文

UInt32 GetSupportedSize(
  [in]  String ResiliencySettingName,
  [out] UInt64 SupportedSizes[],
  [out] UInt64 VirtualDiskSizeMin,
  [out] UInt64 VirtualDiskSizeMax,
  [out] UInt64 VirtualDiskSizeDivisor,
  [out] String ExtendedStatus
);

パラメーター

ResiliencySettingName [in]

サポートされているサイズを判断するときに使用する必要がある回復性設定の名前。 返されるサイズは、回復性設定によって異なる場合があることに注意してください。

SupportedSizes [out]

ストレージ プールでサポートされているすべてのサイズの配列 (バイト単位)。 このパラメーターは、サポートされるサイズの数が多い場合は NULL にできますが、選択した数の仮想ディスク サイズのみをサポートするストレージ プールに役立ちます。

VirtualDiskSizeMin [out]

ストレージ プールに作成された仮想ディスクの最小仮想ディスク サイズ (バイト単位)。

VirtualDiskSizeMax [out]

ストレージ プールに作成された仮想ディスクの最大仮想ディスク サイズ (バイト単位)。

VirtualDiskSizeDivisor [out]

仮想ディスク サイズを判断するときに使用する必要がある乗数を指定します。 作成または変更操作で指定するサイズは、この値の倍数である必要があります。

たとえば、サポートされる最小サイズが 10 GB であり、このパラメーターが 2 GB の場合、サポートされる最大サイズに達するまで、このプールでサポートされるサイズは 10 GB、12 GB、14 GB などになります。

ExtendedStatus [out]

埋め込み MSFT_StorageExtendedStatus オブジェクトを含む文字列。

このパラメーターを使用すると、ストレージ プロバイダーは拡張 (実装固有) エラー情報を返すことができます。

戻り値

Success (0)

Not Supported (1)

Unspecified Error (2)

Timeout (3)

Failed (4)

Invalid Parameter (5)

Access denied (40001)

リソース不足のため、操作を完了できません。 (40002)

Cache out of date (40003)

ストレージ プロバイダーに接続できません。 (46000)

ストレージ プロバイダーがストレージ サブシステムに接続できません。 (46001)

解説

このメソッドが返す値は、ストレージ プールの現在の状態とその使用可能なストレージ容量を反映している必要があります。 SupportedSizes で返されるすべての値は、VirtualDiskSizeDivisor の倍数である必要があります。

要件

要件 Value
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
名前空間 Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

関連項目

MSFT_StoragePool