次の方法で共有


IVssBackupComponents::BackupComplete メソッド (vsbackup.h)

BackupComplete メソッドを使用すると、VSS は BackupComplete イベントを生成します。これにより、バックアップ プロセスが完了したことをライターに通知します。

構文

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

パラメーター

[out] ppAsync

IVssAsync インスタンスへの二重間接ポインター。

戻り値

このメソッドの有効なリターン コードを次に示します。

説明
S_OK
IVssAsync インターフェイスのインスタンスへのポインターが正常に返されました。 pHrResult パラメーターによって返される有効な値については、IVssAsync::QueryStatus を参照してください。
E_INVALIDARG
ppAsync は有効なポインターを指していません。つまり、 NULL です
E_OUTOFMEMORY
呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_BAD_STATE
バックアップ コンポーネント オブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。
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_WRITER_ERROR
ライターとの通信中に予期しないエラーが発生しました。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

解説

コンポーネント モードで作業する場合 (IVssBackupComponents::SetBackupState が select components 引数 TRUE で呼び出されました)、ライターは IVssComponent::GetBackupSucceeded を使用して、バックアップ コンポーネント ドキュメント コンポーネントに明示的に含まれるコンポーネントのバックアップの成功または失敗を判断できます。 したがって、適切に動作するバックアップ アプリケーション (リクエスター) は、各コンポーネントが処理され、BackupComplete を呼び出す前に IVssBackupComponents::SetBackupSucceeded を呼び出す必要があります。

IVssBackupComponents::D oSnapshotSet の呼び出しに失敗した場合は、このメソッドを呼び出さないでください。 要求者がバックアップ操作で DoSnapshotSetSetBackupSucceededBackupComplete を使用する方法の詳細については、「 バックアップ前タスクの概要 」および「 ファイルの実際のバックアップの概要」を参照してください。

この操作は非同期です。 呼び出し元は、返された IVssAsync インターフェイスの QueryStatus インターフェイス メソッドを使用して、通知の状態を確認できます。

BackupComplete を呼び出した後、リクエスターは GatherWriterStatus を呼び出して、ライター セッションを完了状態に設定する必要があります。

メモ これは、Service Pack 2 (SP2) 以前の Windows Server 2008 でのみ必要です。
 
バックアップ アプリケーションは、 IVssAsync::Cancel を呼び出すことによって、シャドウ コピーが作成された後にいつでもバックアップを中止することを選択できます。

呼び出し元のアプリケーションは 、IUnknown::Release を呼び出して、返された IVssAsync によって保持されているリソースが不要になったときに解放します。

要件

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

関連項目

IVssAsync

IVssAsync::Cancel

IVssAsync::QueryStatus

IVssBackupComponents

IVssBackupComponents::SetBackupState

IVssBackupComponents::SetBackupSucceeded