MSFT_VirtualDisk クラスの Resize メソッド
仮想ディスクのサイズを変更します。
構文
UInt32 Resize(
[in, out] UInt64 Size,
[in] Boolean RunAsJob,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
パラメーター
Size [in, out]
入力時、このパラメーターは仮想ディスクに対して要求された新しいサイズ (バイト単位) です。
出力時、このパラメーターは、サイズ変更操作後の仮想ディスクの実際の新しいサイズを受け取ります。
このパラメーターは必須です。
RunAsJob [in]
TRUE の場合、このメソッドは、要求のサービスに時間がかかっているときに CreatedStorageJob パラメーターを使用します。 操作を追跡するためにストレージ ジョブが作成されている場合、このメソッドは Method Parameters Checked - Job Started を返します。
Note
RunAsJob が TRUE の場合でも、十分な時間内に終了していれば、このメソッドは結果を返すことができます。
FALSE または NULL の場合、このメソッドは、クライアントの呼び出し方法によって決定される既定の WMI の非同期動作に従います。 つまり、特に要求されない限りは同期です。
CreatedStorageJob [out]
RunAsJob が TRUE に設定されていて、このメソッドの実行に時間がかかる場合、このパラメーターは、実行時間の長い操作を追跡するために使用されるストレージ ジョブ オブジェクトへの参照を受け取ります。
ExtendedStatus [out]
埋め込み MSFT_StorageExtendedStatus オブジェクトを含む文字列。
このパラメーターを使用すると、ストレージ プロバイダーは拡張 (実装固有) エラー情報を返すことができます。
戻り値
Success (0)
サポート非対称 (1)
Unspecified Error (2)
Timeout (3)
Failed (4)
Invalid Parameter (5)
Method Parameters Checked - Job Started (4096)
サイズがサポートされていません (4097)
Not enough free space (40000)
Access denied (40001)
リソース不足のため、操作を完了できません。 (40002)
ストレージ プロバイダーに接続できません。 (46000)
ストレージ プロバイダーがストレージ サブシステムに接続できません。 (46001)
ストレージ プールの正常性状態または動作状態により、操作を完了できませんでした。 (48006)
ストレージ プールの構成が読み取り専用であるため、操作を完了できませんでした。 (48007)
別のコンピューターが構成を制御しているため、仮想ディスクで操作を完了できませんでした。 (50002)
仮想ディスクの正常性状態または動作状態により不可能なため、操作を完了できませんでした。 (50003)
解説
新しいサイズは、MSFT_StoragePool オブジェクトの GetSupportedSize メソッドによって指定された有効な値の範囲内である必要があります。
要件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 名前空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |