IVssBackupComponents::D oSnapshotSet メソッド (vsbackup.h)

このセット内のすべてのシャドウ コピーを同時にコミットします。

構文

HRESULT DoSnapshotSet(
  [out] IVssAsync **ppAsync
);

パラメーター

[out] ppAsync

必要な IVssAsync 非同期インターフェイスへの二重間接ポインター。 これは、メソッドの実行状態を照会し、最終的なエラー コードを取得するために使用されます。

戻り値

このメソッドの有効なリターン コードを次に示します。 これらのエラー コードは、このメソッドから、または ppAsync パラメーターで返される IVssAsync インターフェイスの QueryStatus メソッドから返される場合があります。

意味
S_OK
IVssAsync インターフェイスのインスタンスへのポインターが正常に返されました。 pHrResult パラメーターによって返される有効な値については、「IVssAsync::QueryStatus」を参照してください。
E_ACCESSDENIED
呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。
E_INVALIDARG
ppAsync は有効なポインターを指していません。つまり、 NULL です
E_OUTOFMEMORY
呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_BAD_STATE
バックアップ コンポーネント オブジェクトが初期化されていないか、 DoSnapshotSet を呼び出す前に、特定のシャドウ コピー コンテキストの前提条件の呼び出しが行われません。
VSS_E_INSUFFICIENT_STORAGE
システムまたはプロバイダーに十分な記憶域がありません。 可能であれば、古いまたは不要な永続的なシャドウ コピーを削除してから、もう一度やり直してください。 このエラー コードは、ppAsync パラメーターで返される IVssAsync インターフェイスの QueryStatus メソッドを介してのみ返されます。
VSS_E_FLUSH_WRITES_TIMEOUT
システムが I/O 書き込みをフラッシュできませんでした。 これは一時的な問題である可能性があります。 10 分待ってから、最大 3 回再試行することをお勧めします。
VSS_E_HOLD_WRITES_TIMEOUT
システムが I/O 書き込みを保持できませんでした。 これは一時的な問題である可能性があります。 10 分待ってから、最大 3 回再試行することをお勧めします。
VSS_E_NESTED_VOLUME_LIMIT
指定されたボリュームが深すぎて VSS 操作に参加できません。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: このリターン コードはサポートされていません。

VSS_E_PROVIDER_VETO
現時点では、プロバイダーは要求を実行できませんでした。 これは一時的な問題である可能性があります。 10 分待ってから、最大 3 回再試行することをお勧めします。 このエラー コードは、ppAsync パラメーターで返される IVssAsync インターフェイスの QueryStatus メソッドを介してのみ返されます。
VSS_E_REBOOT_REQUIRED
プロバイダーで、ユーザーがコンピューターを再起動する必要があるエラーが発生しました。

Windows Server 2003 および Windows XP: この値はサポートされていません。

VSS_E_TRANSACTION_FREEZE_TIMEOUT
分散トランザクション コーディネーター (DTC) またはカーネル トランザクション マネージャー (KTM) を固定できませんでした。

Windows Server 2003 および Windows XP: この値はサポートされていません。

VSS_E_TRANSACTION_THAW_TIMEOUT
システムが分散トランザクション コーディネーター (DTC) またはカーネル トランザクション マネージャー (KTM) を解凍できませんでした。

Windows Server 2003 および Windows XP: この値はサポートされていません。

VSS_E_UNEXPECTED
予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。 代わりに E_UNEXPECTED が使用されます。

VSS_E_UNEXPECTED_PROVIDER_ERROR
プロバイダーから予期しないエラー コードが返されました。 これは一時的な問題である可能性があります。 10 分待ってから、最大 3 回再試行することをお勧めします。 このエラー コードは、ppAsync パラメーターで返される IVssAsync インターフェイスの QueryStatus メソッドを介してのみ返されます。

注釈

呼び出し元は、 IVssAsync インターフェイスの解放を担当します。

別の VHD 内に入れ子になっている仮想ハード ディスク (VHD) に対しては、このメソッドを呼び出すことはできません。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: VHD はサポートされていません。

IVssBackupComponents::D oSnapshotSet を使用して標準のバックアップ シャドウ コピーを作成する方法については、「バックアップ前タスクの概要」と「バックアップ用の単純なシャドウ コピーの作成」を参照してください。 異なる VSS コンテキストで メソッドを使用する方法については、「 シャドウ コピーの作成に関する実装の詳細」を参照してください。

要件

要件
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む)
Library VssApi.lib

こちらもご覧ください

IVssAsync

IVssBackupComponents

IVssBackupComponents::AddComponent

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponents::P repareForBackup

IVssBackupComponents::StartSnapshotSet