IVssComponent::GetAdditionalRestores メソッド (vswriter.h)

  • [アーティクル]

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

ライターまたはリクエスターは、このメソッドを呼び出すことができます。

構文

HRESULT GetAdditionalRestores(
  [out] bool *pbAdditionalRestores
);

パラメーター

[out] pbAdditionalRestores

現在のコンポーネントに対して追加の復元が行われる場合は true 、それ以外の場合は false を受け取る呼び出し元割り当て変数のアドレス。

戻り値

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

値 説明
S_OK
 属性値が正常に返されました。
S_FALSE
 指定した属性に値がありません。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_INVALID_XML_DOCUMENT
 XML ドキュメントが無効です。 詳細については、イベント ログを確認してください。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

解説

復元操作中にリクエスターが IVssBackupComponents::SetAdditionalRestores を呼び出さない限り、GetAdditionalRestores によって返される値は false になります。

コンポーネントを完全に復元するために複数のバックアップ セットを使用する必要がある場合は、GetAdditionalRestores を使用してチェックする必要があります。 コンポーネントを最初に取得するには、完全バックアップからデータを復元してから、1 つ以上の後続の増分バックアップまたは差分バックアップからそのデータを更新します。

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

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

SetAdditionalRestores が false を返すと、復元が完了した後、PostRestore イベントを処理するときに、ライターはその回復操作を完了してオンラインに戻すことができます。

要件

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

関連項目

IVssComponent