IDedupReadFileCallback::OrderContainersRestore メソッド (ddpbackup.h)

このメソッドは、ターゲット ファイルを取得するために必要な保留中の読み取りの順序に影響を与える機能をアプリケーションに提供します。

復元ターゲット ファイルのデータを保持するコンテナー ファイルの一覧を指定すると、コンテナー ファイル エクステントの一覧が並べ替えられた順序で生成され、バックアップ ストアから効率的なコンテナー間読み取りプランが作成されます。

アプリケーションによるこのメソッドの実装は省略可能です。

構文

HRESULT OrderContainersRestore(
  [in]  ULONG                  NumberOfContainers,
  [in]  BSTR                   *ContainerPaths,
  [out] ULONG                  *ReadPlanEntries,
  [out] DEDUP_CONTAINER_EXTENT **ReadPlan
);

パラメーター

[in] NumberOfContainers

ContainerPaths 配列内のコンテナー パスの数。

[in] ContainerPaths

IDedupBackupSupport::RestoreFiles 呼び出しで指定されたファイルを復元するために読み取る必要があるコンテナー ファイルへのパスの配列。 各要素は、ボリュームのルート ディレクトリからコンテナー ファイルへの完全なパスです。

[out] ReadPlanEntries

ReadPlan パラメーターが指す配列内のDEDUP_CONTAINER_EXTENT構造体の数を受け取る ULONG 変数へのポインター。

[out] ReadPlan

DEDUP_CONTAINER_EXTENT構造体の配列を受け取るバッファーへのポインター。

戻り値

このメソッドは、S_OKなどの標準の HRESULT 値を返すことができます。 また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステム エラー コードを返すこともできます。 可能な戻り値は次のとおりです。

注釈

復元ターゲット ファイルのデータを保持するコンテナー ファイルの一覧を指定すると、アプリケーションは必要に応じて、コンテナー ストア ファイル エクステントの一覧を並べ替えられた順序で生成し、効率的なクロスコンテナー読み取りプランになります。 テープ上にあるバックアップ ストアの場合、通常はテープの順序になります。

たとえば、増分バックアップ シーケンスの結果として、コンテナーがバックアップ ストア内の複数のエクステントに格納されている場合、アプリケーションは論理コンテナー ファイルごとに複数のコンテナー エクステントを返す場合もあります。

アプリケーションは、読み取りプランの最適化をスキップするために 、S_OK および NULL 出力パラメーターを返す場合があります。 この場合、コンテナーの読み取り順序はデータ重複除去によって選択されます。

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2012
対象プラットフォーム	Windows
ヘッダー	ddpbackup.h

こちらもご覧ください

DEDUP_CONTAINER_EXTENT

IDedupReadFileCallback