IVssBackupComponents::P repareForBackup メソッド (vsbackup.h)
PrepareForBackup メソッドを使用すると、VSS によって PrepareForBackup イベントが生成され、ライターは今後のバックアップ操作に備えるシグナルを生成します。 これにより、リクエスターのバックアップ コンポーネント ドキュメントをライターが使用できるようになります。
構文
HRESULT PrepareForBackup(
[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が使用されます。 |
注釈
PrepareForBackup は PrepareForBackup イベントを生成します。このイベントは、 CVssWriter::OnPrepareBackup メソッドを介して各ライターの各インスタンスによって処理されます。
PrepareForBackup を呼び出す前に、IVssBackupComponents::SetBackupState を呼び出す必要があります。
Backup Components Document は、 PrepareForBackup イベント ハンドラー (CSVsWriter::OnPrepareBackup) 内のライターによって、その後 BackupComplete イベントが生成されるまで変更できます。
呼び出し元は、 IVssAsync インターフェイスを解放する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む) |
| Library | VssApi.lib |
こちらもご覧ください
IVssBackupComponents::AddComponent
IVssBackupComponents::AddToSnapshotSet