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