IVssBackupComponents::BreakSnapshotSet メソッド (vsbackup.h)
BreakSnapshotSet メソッドを使用すると、VSS によってシャドウ コピー セットの存在が "忘れ" されます。
構文
HRESULT BreakSnapshotSet(
[in] VSS_ID SnapshotSetId
);
パラメーター
[in] SnapshotSetId
シャドウ コピー セット識別子。
戻り値
このメソッドの有効なリターン コードを次に示します。
| 値 | 意味 |
|---|---|
|
シャドウ コピー セットが正常に切断されました。 |
|
呼び出し元に十分なバックアップ特権がないか、管理者ではありません。 |
|
パラメーター値の 1 つが無効です。 |
|
呼び出し元がメモリ不足またはその他のシステム リソースです。 |
|
指定されたシャドウ コピーが存在しません。 |
|
シャドウ コピーはソフトウェア プロバイダーによって作成され、破損することはできません。 |
|
予期しないエラー。 エラー コードはエラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 および Windows 7 まではサポートされません。 代わりに、E_UNEXPECTEDが使用されます。 |
注釈
BreakSnapshotSet は、ハードウェア シャドウ コピー プロバイダーによって作成されたシャドウ コピーにのみ使用できます。 このメソッドは、これらのシャドウ コピーを通常のボリュームにします。
BreakSnapshotSet を使用したボリュームのシャドウ コピーは、スタンドアロン ボリュームとして VSS とは別に管理する必要があります。 詳細については、「 シャドウ コピーの中断 」を参照してください。
IVssBackupComponentsEx2::BreakSnapshotSetEx は BreakSnapshotSet メソッドに似ていますが、状態を照会し、シャドウ コピー セットの破損方法を指定するための追加のパラメーターがある点が異なります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む) |
| Library | VssApi.lib |