IVssBackupComponents::BackupComplete メソッド (vsbackup.h)
BackupComplete メソッドを使用すると、VSS は BackupComplete イベントを生成します。これにより、バックアップ プロセスが完了したことをライターに通知します。
構文
HRESULT BackupComplete(
[out] IVssAsync **ppAsync
);
パラメーター
[out] ppAsync
IVssAsync インスタンスへの二重間接ポインター。
戻り値
このメソッドの有効なリターン コードを次に示します。
| 値 | 説明 |
|---|---|
|
IVssAsync インターフェイスのインスタンスへのポインターが正常に返されました。 pHrResult パラメーターによって返される有効な値については、IVssAsync::QueryStatus を参照してください。 |
|
ppAsync は有効なポインターを指していません。つまり、 NULL です。 |
|
呼び出し元がメモリやその他のシステム リソースを使い切れている。 |
|
バックアップ コンポーネント オブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。 |
|
予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。 代わりに E_UNEXPECTED が使用されます。 |
|
ライターとの通信中に予期しないエラーが発生しました。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。 |
解説
コンポーネント モードで作業する場合 (IVssBackupComponents::SetBackupState が select components 引数 TRUE で呼び出されました)、ライターは IVssComponent::GetBackupSucceeded を使用して、バックアップ コンポーネント ドキュメント コンポーネントに明示的に含まれるコンポーネントのバックアップの成功または失敗を判断できます。 したがって、適切に動作するバックアップ アプリケーション (リクエスター) は、各コンポーネントが処理され、BackupComplete を呼び出す前に IVssBackupComponents::SetBackupSucceeded を呼び出す必要があります。
IVssBackupComponents::D oSnapshotSet の呼び出しに失敗した場合は、このメソッドを呼び出さないでください。 要求者がバックアップ操作で DoSnapshotSet、 SetBackupSucceeded、 BackupComplete を使用する方法の詳細については、「 バックアップ前タスクの概要 」および「 ファイルの実際のバックアップの概要」を参照してください。
この操作は非同期です。 呼び出し元は、返された IVssAsync インターフェイスの QueryStatus インターフェイス メソッドを使用して、通知の状態を確認できます。
BackupComplete を呼び出した後、リクエスターは GatherWriterStatus を呼び出して、ライター セッションを完了状態に設定する必要があります。
呼び出し元のアプリケーションは 、IUnknown::Release を呼び出して、返された IVssAsync によって保持されているリソースが不要になったときに解放します。
要件
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む) |
| Library | VssApi.lib |