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

SetRestoreState メソッドは、復元操作の全体的な構成を定義します。

構文

HRESULT SetRestoreState(
  [in] VSS_RESTORE_TYPE restoreType
);

[in] restoreType

実行する復元の種類を示すVSS_RESTORE_TYPE列挙値。

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

値	説明
S_OK	バックアップの状態が正常に設定されました。
E_INVALIDARG	パラメーター値の 1 つが無効です。
E_OUTOFMEMORY	呼び出し元がメモリやその他のシステムリソースを使い切れている。
VSS_E_BAD_STATE	バックアップコンポーネントオブジェクトが初期化されていないか、このメソッドがバックアップ操作中に呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細については、イベントログを確認してください。詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
VSS_E_UNEXPECTED	予期しないエラー。エラーコードは、エラーログファイルに記録されます。詳細については、「 VSS でのイベントとエラーの処理」を参照してください。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。代わりに E_UNEXPECTED が使用されます。

通常、ほとんどの復元操作では、既定の復元の種類 (VSS_RTYPE_UNDEFINED) をオーバーライドする必要はありません。ライターは、この復元の種類をVSS_RTYPE_BY_COPYと見なす必要があります。

アプリケーションで SetRestoreState を呼び出す必要がある場合は、 IVssBackupComponents::P reRestore を呼び出す前に呼び出す必要があります。

IVssBackupComponents::P reRestore より前に SetRestoreState が呼び出されない場合は、既定の復元状態 () が使用されます。


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