次の方法で共有


IVssBackupComponents::P reRestore メソッド (vsbackup.h)

PreRestore メソッドを使用すると、VSS によって PreRestore イベントが生成され、ライターは今後の復元操作に備える必要があります。

構文

HRESULT PreRestore(
  [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 が使用されます。

注釈

呼び出し元は、 IVssAsync インターフェイス ポインターを解放する役割を担います。

要求元が復元用の自動システム回復 (ASR) ライターを選択した場合は、EFI システムに特別な考慮事項を設ける必要があります。 EFI パーティションを含むディスクに復元していて、次のいずれかの条件が存在する場合は、まず IVdsAdvancedDisk::Clean メソッドを呼び出してディスクをクリーンする必要があります。

  • 前回の ASR バックアップ以降にパーティション分割が変更された EFI システム ディスクに復元しています。
  • バックアップの作成元とは異なる物理ドライブに復元しています。
このディスク クリーニング手順を実行しないと、 PreRestore 中に予期しない結果が発生する可能性があります。

ASR ライターの詳細については、「 インボックス VSS ライター」を参照してください。

要件

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

こちらもご覧ください

IVssAsync

IVssBackupComponents