IVssBackupComponents::D oSnapshotSet メソッド (vsbackup.h)
このセット内のすべてのシャドウ コピーを同時にコミットします。
構文
HRESULT DoSnapshotSet(
[out] IVssAsync **ppAsync
);
パラメーター
[out] ppAsync
必要な IVssAsync 非同期インターフェイスへの二重間接ポインター。 これは、メソッドの実行状態を照会し、最終的なエラー コードを取得するために使用されます。
戻り値
このメソッドの有効なリターン コードを次に示します。 これらのエラー コードは、このメソッドから、または ppAsync パラメーターで返される IVssAsync インターフェイスの QueryStatus メソッドから返される場合があります。
| 値 | 意味 |
|---|---|
|
IVssAsync インターフェイスのインスタンスへのポインターが正常に返されました。 pHrResult パラメーターによって返される有効な値については、「IVssAsync::QueryStatus」を参照してください。 |
|
呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。 |
|
ppAsync は有効なポインターを指していません。つまり、 NULL です。 |
|
呼び出し元がメモリやその他のシステム リソースを使い切れている。 |
|
バックアップ コンポーネント オブジェクトが初期化されていないか、 DoSnapshotSet を呼び出す前に、特定のシャドウ コピー コンテキストの前提条件の呼び出しが行われません。 |
|
システムまたはプロバイダーに十分な記憶域がありません。 可能であれば、古いまたは不要な永続的なシャドウ コピーを削除してから、もう一度やり直してください。 このエラー コードは、ppAsync パラメーターで返される IVssAsync インターフェイスの QueryStatus メソッドを介してのみ返されます。 |
|
システムが I/O 書き込みをフラッシュできませんでした。 これは一時的な問題である可能性があります。 10 分待ってから、最大 3 回再試行することをお勧めします。 |
|
システムが I/O 書き込みを保持できませんでした。 これは一時的な問題である可能性があります。 10 分待ってから、最大 3 回再試行することをお勧めします。 |
|
指定されたボリュームが深すぎて VSS 操作に参加できません。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: このリターン コードはサポートされていません。 |
|
現時点では、プロバイダーは要求を実行できませんでした。 これは一時的な問題である可能性があります。 10 分待ってから、最大 3 回再試行することをお勧めします。 このエラー コードは、ppAsync パラメーターで返される IVssAsync インターフェイスの QueryStatus メソッドを介してのみ返されます。 |
|
プロバイダーで、ユーザーがコンピューターを再起動する必要があるエラーが発生しました。
Windows Server 2003 および Windows XP: この値はサポートされていません。 |
|
分散トランザクション コーディネーター (DTC) またはカーネル トランザクション マネージャー (KTM) を固定できませんでした。
Windows Server 2003 および Windows XP: この値はサポートされていません。 |
|
システムが分散トランザクション コーディネーター (DTC) またはカーネル トランザクション マネージャー (KTM) を解凍できませんでした。
Windows Server 2003 および Windows XP: この値はサポートされていません。 |
|
予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。 代わりに E_UNEXPECTED が使用されます。 |
|
プロバイダーから予期しないエラー コードが返されました。 これは一時的な問題である可能性があります。 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 |
こちらもご覧ください
IVssBackupComponents::AddComponent
IVssBackupComponents::AddToSnapshotSet