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

  • [アーティクル]

SetAdditionalRestores メソッドは、増分または差分の復元操作中にリクエスターによって使用され、特定のコンポーネントが完全に取得するために追加の復元操作を必要とすることをライターに示します。

構文

HRESULT SetAdditionalRestores(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] bool               bAdditionalRestores
);

パラメーター

[in] writerId

ライター識別子。

[in] ct

コンポーネントの種類。 使用可能 な 値については、「VSS_COMPONENT_TYPE」を参照してください。

[in] wszLogicalPath

追加するコンポーネントの論理パスを含む Null で終わるワイド文字列。

詳細については、「 コンポーネントの論理パス」を参照してください。

ここで使用する論理パスを含む文字列の値は、 コンポーネントが IVssBackupComponents::AddComponents を使用してバックアップ セットに追加されたときに使用されたものと同じである必要があります。

論理パスには NULL を指定できます。

NULL 以外の論理パスに出現できる文字に制限はありません。

[in] wszComponentName

コンポーネントの名前を含む Null で終わるワイド文字列。

文字列の値は NULL ではなく、 IVssBackupComponents::AddComponent を使用してコンポーネントがバックアップ セットに追加されたときに使用されたものと同じコンポーネントを含める必要があります。

[in] bAdditionalRestores

このパラメーターの値が true の場合、コンポーネントの追加の復元はこの復元に従います。 値が false の場合、コンポーネントの追加の復元は、この復元に従いません。

戻り値

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

値 説明
S_OK
 追加の復元状態を正常に設定しました。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_BAD_STATE
 バックアップ コンポーネント オブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。
VSS_E_OBJECT_NOT_FOUND
 バックアップ コンポーネントが存在しません。
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 が使用されます。

解説

SetAdditionalRestores メソッドによって提供される情報は、通常、PostRestore イベント ハンドラー (CVssWriter::OnPostRestore) の一部として明示的な回復メカニズムをサポートするライター (たとえば、Exchange Server、SQL Serverなどのデータベース アプリケーション) で使用されます。 これらのアプリケーションでは、多くの場合、このような回復が実行された後に追加の差分、増分、またはログの復元を実行することはできません。

したがって、コンポーネントの SetAdditionalRestores が true に設定されている場合、このようなライターは明示的な回復メカニズムを実行せず、追加の差分、増分、またはログの復元が実行されることを想定する必要があります。

コンポーネントの SetAdditionalRestores が false に設定されている場合、コンポーネントが復元された後、アプリケーションはその回復操作を完了してオンラインに戻すことができます。

このメソッドは、 IVssBackupComponents::P reRestore の前に呼び出す必要があります。

要件

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

関連項目

IVssBackupComponents

IVssBackupComponents::P reRestore

VSS_COMPONENT_TYPE