IVssBackupComponentsEx2::SetRollForward メソッド (vsbackup.h)
コンポーネントのロールフォワード操作の種類を設定し、部分ロールフォワード操作の復元ポイントを指定します。
構文
HRESULT SetRollForward(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] VSS_ROLLFORWARD_TYPE rollType,
[in] LPCWSTR wszRollForwardPoint
);
パラメーター
[in] writerId
ライター クラスのグローバル一意識別子 (GUID)。
[in] ct
コンポーネントの種類です。 使用可能な値については、 VSS_COMPONENT_TYPE 列挙を参照してください。
[in] wszLogicalPath
コンポーネントの論理パスを含む null で終わるワイド文字列。 詳細については、「 コンポーネントの論理パス」を参照してください。
ここで使用する論理パスを含む文字列の値は、コンポーネントの追加時に使用された文字列と同じである必要があります。
論理パスには NULL を指定できます。
NULL 以外の論理パスに出現できる文字に制限はありません。
[in] wszComponentName
コンポーネントの名前を含む null で終わるワイド文字列。
文字列を NULL にすることはできません。また、 コンポーネントが IVssBackupComponents::AddComponent メソッドを使用してバックアップ セットに追加されたときに使用された文字列と同じコンポーネント名を含める必要があります。
[in] rollType
実行するロールフォワード操作の種類を示す VSS_ROLLFORWARD_TYPE 列挙値。
[in] wszRollForwardPoint
ロールフォワード復元ポイントを指定する null で終わるワイド文字列。
この文字列の形式はライターによって定義され、タイムスタンプ、ログ シーケンス番号 (LSN)、またはライターによって定義された任意のマーカーを指定できます。
戻り値
このメソッドの有効なリターン コードを次に示します。
| 値 | 意味 |
|---|---|
|
ロールフォワード操作の種類と復元ポイントが正常に設定されました。 |
|
パラメーター値の 1 つが無効です。 |
|
呼び出し元がメモリやその他のシステム リソースを使い切れている。 |
|
このメソッドは、復元操作中に呼び出されませんでした。 |
|
指定されたコンポーネントが見つかりませんでした。 |
|
予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。 代わりに E_UNEXPECTED が使用されます。 |
注釈
SetRollForward メソッドは、復元操作中にのみ呼び出すことができます。
ライターは、バックアップ スキーマ マスクで VSS_BS_ROLLFORWARD_RESTORE フラグを設定することで、このメソッドをサポートしていることを示します。
詳細については、「 VSS 復元オプションの設定」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む) |
| Library | VssApi.lib |