VSS_RESTORE_TARGET

列挙型

基底型i4

メンバー 5

名前	10進	16進	説明
VSS_RT_UNDEFINED	0	0x0	ターゲットが定義されていません。この値はライター側のエラーを示します。この値は express ライターではサポートされません。
VSS_RT_ORIGINAL	1	0x1	これは既定の復元ターゲットです。この値は、選択されたコンポーネント (またはそのコンポーネントが定義するコンポーネントセット) に含まれるファイルの復元を、バックアップ時に VSS_RESTOREMETHOD_ENUM の値によって指定された元の復元メソッドに従って行うことを示します。
VSS_RT_ALTERNATE	2	0x2	既存の代替場所マッピングから決定される場所にファイルが復元されます。復元ターゲットに VSS_RT_ALTERNATE を設定するのは、選択されたコンポーネントまたはコンポーネントセットが管理するすべてのファイルに対して代替場所マッピングが設定されている場合のみにしてください。この値は express ライターではサポートされません。
VSS_RT_DIRECTED	3	0x3	ファイルの復元時に、ライターによる指定ターゲット指定 (directed targeting) を使用します。指定ターゲット指定を使用すると、ライターはファイル単位で復元方法を制御できます。すなわち、ファイルのどの部分を復元するか、およびバックアップされたファイルをどのファイルに復元するかを指定できます。この値は express ライターではサポートされません。
VSS_RT_ORIGINAL_LOCATION	4	0x4	バックアップ時に指定された元の復元メソッドが VSS_RME_RESTORE_TO_ALTERNATE_LOCATION であった場合でも、ファイルはバックアップ時に存在していた場所に復元されます。 Windows Server 2003 および Windows XP: この値はサポートされません。この値は express ライターではサポートされません。

公式ドキュメント

VSS_RESTORE_TARGET 列挙型は、復元時にライターが使用し、選択されたコンポーネントに含まれるすべてのファイル、およびそのコンポーネントが定義するコンポーネントセット内のすべてのファイルをどのように復元するかを示します。(コンポーネントの選択については Working with Selectability and Logical Paths を参照してください。)

復元ターゲットを設定すると、バックアップ時に設定された復元メソッドが変更または上書きされます (VSS_RESTOREMETHOD_ENUM を参照)。

解説(Remarks)

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

バックアップ時に、ライターは IVssCreateWriterMetadata::SetRestoreMethod で設定される復元メソッド (VSS_RESTOREMETHOD_ENUM) を指定することにより、既定の復元動作を設定します。

ライターがコンポーネントおよびそれが定義するコンポーネントセットの復元ターゲットを明示的に設定しない場合、既定では VSS_RT_ORIGINAL が設定されます。

復元時には、VSS_RT_ORIGINAL 以外の VSS_RESTORE_TARGET の値は、VSS_RESTOREMETHOD_ENUM によって指定され IVssCreateWriterMetadata::SetRestoreMethod によって設定された、元々指定されていた復元メソッドの値を上書きします。

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

リクエスターとライターは、IVssComponent::GetRestoreTarget を通じて現在の復元ターゲットにアクセスできます。

VSS_RT_ORIGINAL の復元ターゲットは、ファイルを元の場所に復元すべきであることを意味するのではなく、元々指定された復元メソッド (VSS_RESTOREMETHOD_ENUM) を尊重しなければならないことを意味します。たとえば、ライターが選択されたコンポーネントに対して VSS_RME_RESTORE_TO_ALTERNATE_LOCATION の復元メソッドを設定し、復元ターゲットが VSS_RT_ORIGINAL である場合、ファイルはライターが定義した代替場所に復元されます。

(この例で、ライターが代替場所マッピングを定義していない場合はライターのエラーであり、リクエスターはそれを報告する必要があります。)

代替場所マッピングが定義されていない状態での VSS_RT_ALTERNATE の復元ターゲットはライターのエラーであり、リクエスターはその旨を報告する必要があります。

詳細については Non-Default Backup And Restore Locations を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum VSS_RESTORE_TARGET : int {
    VSS_RT_UNDEFINED = 0,
    VSS_RT_ORIGINAL = 1,
    VSS_RT_ALTERNATE = 2,
    VSS_RT_DIRECTED = 3,
    VSS_RT_ORIGINAL_LOCATION = 4
} VSS_RESTORE_TARGET;

public enum VSS_RESTORE_TARGET : int
{
    VSS_RT_UNDEFINED = 0,
    VSS_RT_ORIGINAL = 1,
    VSS_RT_ALTERNATE = 2,
    VSS_RT_DIRECTED = 3,
    VSS_RT_ORIGINAL_LOCATION = 4,
}

Public Enum VSS_RESTORE_TARGET As Integer
    VSS_RT_UNDEFINED = 0
    VSS_RT_ORIGINAL = 1
    VSS_RT_ALTERNATE = 2
    VSS_RT_DIRECTED = 3
    VSS_RT_ORIGINAL_LOCATION = 4
End Enum

import enum

class VSS_RESTORE_TARGET(enum.IntEnum):
    VSS_RT_UNDEFINED = 0
    VSS_RT_ORIGINAL = 1
    VSS_RT_ALTERNATE = 2
    VSS_RT_DIRECTED = 3
    VSS_RT_ORIGINAL_LOCATION = 4

// VSS_RESTORE_TARGET
pub const VSS_RT_UNDEFINED: i32 = 0;
pub const VSS_RT_ORIGINAL: i32 = 1;
pub const VSS_RT_ALTERNATE: i32 = 2;
pub const VSS_RT_DIRECTED: i32 = 3;
pub const VSS_RT_ORIGINAL_LOCATION: i32 = 4;

// VSS_RESTORE_TARGET
const (
	VSS_RT_UNDEFINED int32 = 0
	VSS_RT_ORIGINAL int32 = 1
	VSS_RT_ALTERNATE int32 = 2
	VSS_RT_DIRECTED int32 = 3
	VSS_RT_ORIGINAL_LOCATION int32 = 4
)

const
  VSS_RT_UNDEFINED = 0;
  VSS_RT_ORIGINAL = 1;
  VSS_RT_ALTERNATE = 2;
  VSS_RT_DIRECTED = 3;
  VSS_RT_ORIGINAL_LOCATION = 4;

// VSS_RESTORE_TARGET
pub const VSS_RT_UNDEFINED: i32 = 0;
pub const VSS_RT_ORIGINAL: i32 = 1;
pub const VSS_RT_ALTERNATE: i32 = 2;
pub const VSS_RT_DIRECTED: i32 = 3;
pub const VSS_RT_ORIGINAL_LOCATION: i32 = 4;

const
  VSS_RT_UNDEFINED* = 0
  VSS_RT_ORIGINAL* = 1
  VSS_RT_ALTERNATE* = 2
  VSS_RT_DIRECTED* = 3
  VSS_RT_ORIGINAL_LOCATION* = 4

enum VSS_RESTORE_TARGET : int {
    VSS_RT_UNDEFINED = 0,
    VSS_RT_ORIGINAL = 1,
    VSS_RT_ALTERNATE = 2,
    VSS_RT_DIRECTED = 3,
    VSS_RT_ORIGINAL_LOCATION = 4,
}

#define global VSS_RT_UNDEFINED         0x0
#define global VSS_RT_ORIGINAL          0x1
#define global VSS_RT_ALTERNATE         0x2
#define global VSS_RT_DIRECTED          0x3
#define global VSS_RT_ORIGINAL_LOCATION 0x4