次の方法で共有

VSS_RESTORE_TARGET列挙 (vswriter.h)

  • [アーティクル]

VSS_RESTORE_TARGET列挙は、復元時にライターによって使用され、選択したコンポーネントに含まれるすべてのファイルと、それが定義するコンポーネント セット内のすべてのファイルを復元する方法を示します。 (コンポーネント の選択については、「選択可能性と論理パスの操作 」を参照してください)。

復元ターゲットを設定すると、バックアップ中に設定された復元方法が変更またはオーバーライドされます ( 「VSS_RESTOREMETHOD_ENUM」を参照してください)。

構文

typedef enum VSS_RESTORE_TARGET {
  VSS_RT_UNDEFINED = 0,
  VSS_RT_ORIGINAL,
  VSS_RT_ALTERNATE,
  VSS_RT_DIRECTED,
  VSS_RT_ORIGINAL_LOCATION
} ;

定数

 
VSS_RT_UNDEFINED
値: 0
ターゲットが定義されていません。


この値は、ライター側のエラーを示します。

この値は、高速ライターではサポートされていません。
VSS_RT_ORIGINAL
これが既定の復元ターゲットです。


この値は、選択したコンポーネント (またはコンポーネント セット) に含まれるファイルの復元を示します。
そのコンポーネントによって定義されている) は、バックアップ時に指定された元の復元方法に従って続行する必要があります。
VSS_RESTOREMETHOD_ENUM値。
VSS_RT_ALTERNATE
ファイルは、既存の代替場所マッピングから決定された場所に復元されます。


復元先は、別の場所 の 場合にのみVSS_RT_ALTERNATEに設定する必要があります
マッピングは、選択したコンポーネントまたはコンポーネント セットによって管理されるすべてのファイルに対して設定されています。

この値は、高速ライターではサポートされていません。
VSS_RT_DIRECTED
復元時にライターによるダイレクト ターゲット設定を使用して、ファイルを復元します。


ダイレクト ターゲット設定を使用すると、ライターはファイルごとにファイルの動作を制御できます
復元されるファイルの量と復元先のファイルの量を示します。
バックアップされたファイルが復元されます。

この値は、高速ライターではサポートされていません。
VSS_RT_ORIGINAL_LOCATION
ファイルは、元のファイルがバックアップ時の場所に復元されます。
バックアップ時に指定された復元方法は、
VSS_RME_RESTORE_TO_ALTERNATE_LOCATION。


Windows Server 2003 および Windows XP: この値はサポートされていません。

この値は、高速ライターではサポートされていません。

注釈

VSS_RT_UNDEFINEDのターゲットは、エラー状態を示します。

ライターは、バックアップ時に、IVssCreateWriterMetadata::SetRestoreMethod で設定された復元方法 (VSS_RESTOREMETHOD_ENUM) を示すことによって、既定の復元動作を設定します。

ライターがコンポーネントの復元ターゲットを明示的に設定せず、定義されているコンポーネント セットがある場合、既定では VSS_RT_ORIGINAL に設定されます。

復元時に、VSS_RT_ORIGINAL以外の VSS_RESTORE_TARGET 値は、 VSS_RESTOREMETHOD_ENUMで指定 され、 IVssCreateWriterMetadata::SetRestoreMethod によって設定された元の復元方法の値をオーバーライドします。

ライター ( IVssComponent::SetRestoreTarget を使用) のみが復元ターゲット (VSS_RESTORE_TARGET) を設定し、復元方法をオーバーライドしてファイルを復元する方法を変更できます。

要求者とライターは、 IVssComponent::GetRestoreTarget を介して現在の復元ターゲットにアクセスできます。

VSS_RT_ORIGINALの復元ターゲットは、ファイルを元の場所に復元する必要があるのではなく、最初に指定した復元方法 (VSS_RESTOREMETHOD_ENUM) を尊重する必要があることを意味します。 たとえば、ライターが選択したコンポーネント にVSS_RME_RESTORE_TO_ALTERNATE_LOCATION の復元方法を設定し、復元先が VSS_RT_ORIGINAL場合は、ライターによって定義された別の場所にファイルを復元する必要があります。

(この例では、ライターが代替の場所マッピングを定義できなかった場合は、ライター エラーであり、要求者はそれを報告する必要があります)。

別の場所マッピングが定義されていない VSS_RT_ALTERNATE の復元ターゲットはライター エラーを構成し、リクエスターはそれをそのように報告する必要があります。

詳細については、「 既定以外のバックアップと復元の場所 」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header vswriter.h

こちらもご覧ください

IVssComponent::GetRestoreTarget

IVssComponent::SetRestoreTarget

VSS_RESTOREMETHOD_ENUM