MSFT_VirtualDisk クラスの CreateSnapshot メソッド

既存の仮想ディスクのシャドウ コピーである新しい仮想ディスクを作成します。

構文

UInt32 CreateSnapshot(
  [in]  String              FriendlyName,
  [in]  String              TargetStoragePoolName,
  [in]  Boolean             RunAsJob,
  [out] MSFT_StorageJob REF CreatedStorageJob,
  [out] String              CreatedVirtualDisk,
  [out] String              ExtendedStatus
);

パラメーター

FriendlyName [in]

シャドウ コピー仮想ディスクの目的の名前。

このパラメーターは必須であり、NULL にすることはできません。

TargetStoragePoolName [in]

作成されたスナップショットを保持するために使用されるストレージ プール。 このパラメーターが設定されていない場合、このメソッドは既定で、ソース仮想ディスクを含む同じストレージ プールを使用します。

RunAsJob [in]

TRUE の場合、このメソッドは、要求のサービスに時間がかかっているときに CreatedStorageJob パラメーターを使用します。 操作を追跡するためにストレージ ジョブが作成されている場合、このメソッドは Method Parameters Checked - Job Started を返します。

Note

RunAsJob が TRUE の場合でも、十分な時間内に終了していれば、このメソッドは結果を返すことができます。

FALSE または NULL の場合、このメソッドは、クライアントの呼び出し方法によって決定される既定の WMI の非同期動作に従います。 つまり、特に要求されない限りは同期です。

CreatedStorageJob [out]

RunAsJob が TRUE に設定されていて、このメソッドの実行に時間がかかる場合、このパラメーターは、実行時間の長い操作を追跡するために使用されるストレージ ジョブ オブジェクトへの参照を受け取ります。

CreatedVirtualDisk [out]

仮想ディスクが正常に作成された場合、このパラメーターは埋め込み MSFT_VirtualDisk オブジェクトを含む文字列を受け取ります。

ExtendedStatus [out]

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

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

戻り値

Success (0)

サポート非対称 (1)

Unspecified Error (2)

Timeout (3)

Failed (4)

Invalid Parameter (5)

Method Parameters Checked - Job Started (4096)

Not enough free space (40000)

Access denied (40001)

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

Cache out of date (40003)

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

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

この操作は、プリモディアル ストレージ プールではサポートされていません。 (48000)

ストレージ プールは特別な用途専用に予約されています。 (48001)

指定されたストレージ プールが見つかりませんでした。 (48005)

ストレージ プールの正常性状態または動作状態により、操作を完了できませんでした。 (48006)

要件

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

関連項目

MSFT_VirtualDisk