VSS_FILE_SPEC_BACKUP_TYPE列挙 (vss.h)

[アーティクル]
03/13/2024

VSS_FILE_SPEC_BACKUP_TYPE列挙は、ファイルセット (指定されたファイルまたはファイル) に基づいて、増分バックアップや差分バックアップなどの特定のバックアップ操作のサポートを示すためにライターによって使用されます。

ライターメタデータドキュメントに格納されているファイルセットには、次を示す VSS_FILE_SPEC_BACKUP_TYPE 値のビットマスク (またはビットごとの OR) でタグが付けられます。

指定した種類のバックアップ操作に参加するために、ライターと要求者が特定のファイルセットを評価する必要があるかどうか
指定したファイルをバックアップする際にシャドウコピーが必要かどうか

構文

typedef enum _VSS_FILE_SPEC_BACKUP_TYPE {
  VSS_FSBT_FULL_BACKUP_REQUIRED = 0x1,
  VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED = 0x2,
  VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED = 0x4,
  VSS_FSBT_LOG_BACKUP_REQUIRED = 0x8,
  VSS_FSBT_FULL_SNAPSHOT_REQUIRED = 0x100,
  VSS_FSBT_DIFFERENTIAL_SNAPSHOT_REQUIRED = 0x200,
  VSS_FSBT_INCREMENTAL_SNAPSHOT_REQUIRED = 0x400,
  VSS_FSBT_LOG_SNAPSHOT_REQUIRED = 0x800,
  VSS_FSBT_CREATED_DURING_BACKUP = 0x10000,
  VSS_FSBT_ALL_BACKUP_REQUIRED = 0xf,
  VSS_FSBT_ALL_SNAPSHOT_REQUIRED = 0xf00
} VSS_FILE_SPEC_BACKUP_TYPE, *PVSS_FILE_SPEC_BACKUP_TYPE;

定数


`VSS_FSBT_FULL_BACKUP_REQUIRED` 値: 0x1 この値でタグ付けされたファイルセットは、すべての種類のバックアップ操作に関係している必要があります。ライターは、この値を使用してファイルセットにタグを付け、現在のファイルのコピーを要求者に示します。を使用してバックアップ操作を復元した後に使用可能に設定されたファイルのバージョンのVSS_BACKUP_TYPE VSS_BT_FULL。
`VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED` 値: 0x2 ライターは、この値を使用してファイルセットにタグを付け、現在のファイルのコピーを要求者に示します。を使用してバックアップ操作を復元した後に使用可能に設定されたファイルのバージョンのVSS_BACKUP_TYPE VSS_BT_DIFFERENTIAL。この値は、高速ライターではサポートされていません。
`VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED` 値: 0x4 ライターは、この値を使用してファイルセットにタグを付け、現在のファイルのコピーを要求者に示します。を使用してバックアップ操作を復元した後に使用可能に設定されたファイルのバージョンのVSS_BACKUP_TYPE VSS_BT_INCREMENTAL。この値は、高速ライターではサポートされていません。
`VSS_FSBT_LOG_BACKUP_REQUIRED` 値: 0x8 ライターは、この値を使用してファイルセットにタグを付け、現在のファイルのコピーを要求者に示します。を使用してバックアップ操作を復元した後に使用可能に設定されたファイルのバージョンのVSS_BACKUP_TYPE VSS_BT_LOG。この値は、高速ライターではサポートされていません。
`VSS_FSBT_FULL_SNAPSHOT_REQUIRED` 値: 0x100 この値でタグ付けされたファイルセットは、ボリュームのシャドウコピーからバックアップする必要があります (また、元のボリューム) を使用してバックアップ操作に参加する場合は、のVSS_BACKUP_TYPE VSS_BT_FULL。
`VSS_FSBT_DIFFERENTIAL_SNAPSHOT_REQUIRED` 値: 0x200 この値でタグ付けされたファイルセットは、ボリュームのシャドウコピーからバックアップする必要があります (また、元のボリューム) を使用してバックアップ操作に参加する場合は、のVSS_BACKUP_TYPE VSS_BT_DIFFERENTIAL。
`VSS_FSBT_INCREMENTAL_SNAPSHOT_REQUIRED` 値: 0x400 この値でタグ付けされたファイルセットは、ボリュームのシャドウコピーからバックアップする必要があります (また、元のボリューム) を使用してバックアップ操作に参加する場合は、のVSS_BACKUP_TYPE VSS_BT_INCREMENTAL。
`VSS_FSBT_LOG_SNAPSHOT_REQUIRED` 値: 0x800 この値でタグ付けされたファイルセットは、ボリュームのシャドウコピーからバックアップする必要があります (また、元のボリューム) を使用してバックアップ操作に参加する場合は、のVSS_BACKUP_TYPE VSS_BT_LOG)。
`VSS_FSBT_CREATED_DURING_BACKUP` 値: 0x10000 ライターは、この値を使用してファイルセットにタグを付け、スナップショットシーケンス中にファイルが作成されることを要求者に示します。
`VSS_FSBT_ALL_BACKUP_REQUIRED` 値: 0xf 既定のファイルバックアップ仕様の種類。この値でタグ付けされたファイルセットは、常にに参加している必要がありますバックアップと復元の操作。
`VSS_FSBT_ALL_SNAPSHOT_REQUIRED` 値: 0xf00 バックアップのシャドウコピーの要件。この値でタグ付けされたファイルセットは、常にからバックアップする必要があります。バックアップ操作に参加している場合は、ボリュームのシャドウコピー (および元のボリュームからのシャドウコピーではありません)。

注釈

ライターが VSS_FILE_SPEC_BACKUP_TYPE 列挙のバックアップが必要な値を設定すると、バックアップが復元されると、現在のバージョンのファイルセットが復元されるように要求者がバックアップを実行することを示します。通常、これは、ファイルセットがバックアップの一部としてコピーされることを意味します。

この設定は、ファイルが差分ファイル ( IVssComponent::AddDifferencedFilesByLastModifyTime を使用) または部分ファイル ( IVssComponent::AddPartialFile を使用) としてバックアップコンポーネントドキュメントに追加される場合にオーバーライドできます。

ファイルが異なるファイルとして追加された場合、ライターは、要求者が実際にファイルをバックアップメディアにコピーするかどうかを決定する基準を確立します。ライターは通常、バックアップ PostSnapshot イベントに含めるために、バックアップコンポーネントドキュメントに異なるファイルを追加します ( 「CVssWriter::OnPostSnapshot」を参照)。詳細については、「増分バックアップと差分バックアップ」を参照してください。

ライターは、 VSS_FILE_SPEC_BACKUP_TYPE 列挙のシャドウコピーが必要な値を設定すると、シャドウコピーされたボリュームからファイルセットをバックアップする必要があることを示します。シャドウコピーが必要な値でタグ付けされていないファイルセットは、元のボリュームからバックアップできます。

ライターは、Identify イベントの処理中VSS_FILE_SPEC_BACKUP_TYPE値を設定します (「CSVsWriter::OnIdentify」を参照)。

IVssCreateWriterMetadata::AddFilesToFileGroup メソッド、IVssCreateWriterMetadata::AddDatabaseFiles メソッド、または IVssCreateWriterMetadata::AddDatabaseLogFiles メソッドを使用して、VSS_FILE_SPEC_BACKUP_TYPE値のビットマスク (またはビットごとの OR) をファイルセットに適用できます。

コンポーネントへのファイル指定の追加中に明示的なファイル仕様のバックアップの種類が指定されていない場合、仕様には既定の VSS_FILE_SPEC_BACKUP_TYPE 値 (VSS_FSBT_ALL_BACKUP_REQUIRED |VSS_FSBT_ALL_SNAPSHOT_REQUIRED)。

要求者またはライターは、 IVssWMFiledesc::GetBackupTypeMask メソッドを使用して、ファイルセットのファイル仕様のバックアップの種類を回復できます。

要件

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