VSS_VOLUME_SNAPSHOT_ATTRIBUTES列挙 (vss.h)

  • [アーティクル]

シャドウ コピーに対して追加の属性を指定できるようにします。 シャドウ コピーのコンテキスト ( IVssBackupComponents::SetContext メソッドによって設定) は、 _VSS_VOLUME_SNAPSHOT_ATTRIBUTES と _VSS_SNAPSHOT_CONTEXT 列挙値の有効な組み合わせを含むビットマスクによって変更できます。

構文

typedef enum _VSS_VOLUME_SNAPSHOT_ATTRIBUTES {
  VSS_VOLSNAP_ATTR_PERSISTENT = 0x1,
  VSS_VOLSNAP_ATTR_NO_AUTORECOVERY = 0x2,
  VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE = 0x4,
  VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE = 0x8,
  VSS_VOLSNAP_ATTR_NO_WRITERS = 0x10,
  VSS_VOLSNAP_ATTR_TRANSPORTABLE = 0x20,
  VSS_VOLSNAP_ATTR_NOT_SURFACED = 0x40,
  VSS_VOLSNAP_ATTR_NOT_TRANSACTED = 0x80,
  VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED = 0x10000,
  VSS_VOLSNAP_ATTR_DIFFERENTIAL = 0x20000,
  VSS_VOLSNAP_ATTR_PLEX = 0x40000,
  VSS_VOLSNAP_ATTR_IMPORTED = 0x80000,
  VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY = 0x100000,
  VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY = 0x200000,
  VSS_VOLSNAP_ATTR_AUTORECOVER = 0x400000,
  VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY = 0x800000,
  VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT = 0x1000000,
  VSS_VOLSNAP_ATTR_TXF_RECOVERY = 0x2000000,
  VSS_VOLSNAP_ATTR_FILE_SHARE = 0x4000000
} VSS_VOLUME_SNAPSHOT_ATTRIBUTES, *PVSS_VOLUME_SNAPSHOT_ATTRIBUTES;

定数

 
VSS_VOLSNAP_ATTR_PERSISTENT
値: 0x1
シャドウ コピーは再起動後も永続的です。


この属性は、 に対して自動的に設定されます。
のコンテキストを_VSS_SNAPSHOT_CONTEXT する
VSS_CTX_APP_ROLLBACK、 VSS_CTX_CLIENT_ACCESSIBLE、
VSS_CTX_CLIENT_ACCESSIBLE_WRITERS、および
VSS_CTX_NAS_ROLLBACK。

シャドウ コピーのコンテキストを設定するときは、この属性を要求者が明示的に使用しないでください。
VSS_VOLSNAP_ATTR_NO_AUTORECOVERY
値: 0x2
シャドウ コピーの自動回復は無効になっています。

リクエスターは、この属性のビットごとの OR を使用してシャドウ コピー コンテキストを変更できます。 これを行うことで、リクエスターは VSS に対して、シャドウ コピーの作成直後にシャドウ コピーを読み取り専用にするように指示し、ライターや他のアプリケーションがシャドウ コピー内のコンポーネントを更新することを許可しません。

自動回復を無効にすると、トランザクション NTFS (TxF) によって管理されるトランザクションの読み取り操作や書き込み操作など、トランザクション データベース操作に関連するコンポーネントがある場合、シャドウ コピーの状態が不整合になる可能性があります。 これは、自動回復を無効にすると、不完全なトランザクションがロールバックされないためです。

自動回復を無効にすると、ライターがシャドウ コピーからファイルを除外することもできなくなります。 自動回復が無効になっている場合でも、ライターは IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot メソッドを呼び出すことができますが、ライターの CVssWriter::OnPostSnapshot メソッドはシャドウ コピーからファイルを削除できません。

Windows Server 2003 および Windows XP: この値は、Windows Vista までサポートされていません。
VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE
値: 0x4
指定されたシャドウ コピーは、 共有フォルダーのシャドウ コピーをサポートするクライアントがアクセスできるシャドウ コピー であり、公開しないでください。

この属性は、 VSS_CTX_CLIENT_ACCESSIBLEとVSS_CTX_CLIENT_ACCESSIBLE_WRITERS に自動的 に設定されます。

シャドウ コピーのコンテキストを設定するときは、この属性を要求者が明示的に使用しないでください。
VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE
値: 0x8
シャドウ コピーリクエスター プロセスが終了しても、シャドウ コピーは自動的に削除されません。 シャドウ コピー
は、 の呼び出しによってのみ削除できます。
IVssBackupComponents::D eleteSnapshots。


この属性は、 に対して自動的に設定されます。
のコンテキストを_VSS_SNAPSHOT_CONTEXT する
VSS_CTX_APP_ROLLBACK、 VSS_CTX_CLIENT_ACCESSIBLE、
VSS_CTX_CLIENT_ACCESSIBLE_WRITERS、および
VSS_CTX_NAS_ROLLBACK。

シャドウ コピーのコンテキストを設定するときは、この属性を要求者が明示的に使用しないでください。
VSS_VOLSNAP_ATTR_NO_WRITERS
値: 0x10
シャドウ コピーの作成にライターは関与しません。


この属性は、 に対して自動的に設定されます。
のコンテキストを_VSS_SNAPSHOT_CONTEXT する
VSS_CTX_NAS_ROLLBACK、 VSS_CTX_FILE_SHARE_BACKUP、および
VSS_CTX_CLIENT_ACCESSIBLE。

シャドウ コピーのコンテキストを設定するときは、この属性を要求者が明示的に使用しないでください。
VSS_VOLSNAP_ATTR_TRANSPORTABLE
値: 0x20
シャドウ コピーは転送されるため、ローカルに表示しないでください。


この属性は、シャドウ コピーのコンテキストを設定するときに要求者が明示的に使用できます。
シャドウ コピーのプロバイダーは、トランスポート可能なシャドウ コピーをサポートします。

Windows Server 2003、Standard Edition、Windows Server 2003、Web Edition、Windows XP: この属性はサポートされていません。 SP1 を使用する Windows Server 2003 のすべてのエディションでは、この属性がサポートされています。

「Transportable のインポート」を参照してください 。
詳細については、「シャドウ コピーされたボリューム 」を参照してください。
VSS_VOLSNAP_ATTR_NOT_SURFACED
値: 0x40
シャドウ コピーは現在公開されていません。


シャドウ コピーが明示的に公開またはマウントされていない限り、この属性はすべてのシャドウ コピーに対して設定されます。

シャドウ コピーのコンテキストを設定するときは、この属性を要求者が明示的に使用しないでください。
VSS_VOLSNAP_ATTR_NOT_TRANSACTED
値: 0x80
シャドウ コピーはトランザクションされません。

リクエスターは、この属性のビットごとの OR を使用してシャドウ コピー コンテキストを変更できます。 これを行うことで、リクエスターは VSS とトランザクションとリソース マネージャー間の組み込み統合を無効にするように VSS に指示します。

この属性を設定すると、リクエスターはVSS_E_TRANSACTION_FREEZE_TIMEOUTエラーを受け取りません。 ただし、トランザクションの整合性の損失やデータの損失など、望ましくない結果を引き起こす可能性があります。

Windows Server 2003 および Windows XP: この値は、Windows Vista までサポートされていません。
VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED
値: 0x10000
特定のプロバイダーがハードウェア プロバイダーであることを示します。


この属性は、ハードウェア プロバイダーに対して自動的に設定されます。

この列挙値を使用してコンテキストを手動で設定することはできません (を使用して、
IVssBackupComponents::SetContext
メソッド)、この列挙値のビット マスク (またはビットごとの OR) と有効なシャドウ コピーによるシャドウ コピーの
のコンテキスト値
_VSS_SNAPSHOT_CONTEXT。
VSS_VOLSNAP_ATTR_DIFFERENTIAL
値: 0x20000
特定のプロバイダーが差分データまたは書き込み時のコピー メカニズムを使用してシャドウ コピーを実装することを示します。


リクエスターは、この属性のビットごとの OR を使用してシャドウ コピー コンテキストを変更できます。 これを行うことで、次の操作を行います。
requester は、差分実装を使用してシャドウ コピーを作成するようにプロバイダーに指示します。 シャドウ コピーがない場合
システムにインストールされているプロバイダーは、要求された属性をサポートしています。VSS_E_VOLUME_NOT_SUPPORTED エラーは
戻り値
IVssBackupComponents::AddToSnapshotSet。
VSS_VOLSNAP_ATTR_PLEX
値: 0x40000
特定のプロバイダーが PLEX またはミラー分割メカニズムを使用してシャドウ コピーを実装することを示します。


リクエスターは、この属性のビットごとの OR を使用してシャドウ コピー コンテキストを変更できます。 これを行うことで、次の操作を行います。
要求者は、PLEX 実装を使用してシャドウ コピーを作成するようにプロバイダーに指示します。 シャドウ コピーがない場合
システムにインストールされているプロバイダーは、要求された属性をサポートしています。VSS_E_VOLUME_NOT_SUPPORTED エラーは
戻り値
IVssBackupComponents::AddToSnapshotSet。
VSS_VOLSNAP_ATTR_IMPORTED
値: 0x80000
ボリュームのシャドウ コピーは、 を使用してこのマシンにインポートされました。
IVssBackupComponents::ImportSnapshots
メソッドを使用して作成されるのではなく、
IVssBackupComponents::D oSnapshotSet
メソッドをオーバーライドします。


この属性は、シャドウ コピーがインポートされた場合に自動的に設定されます。

シャドウ コピーのコンテキストを設定するときは、この属性を要求者が明示的に使用しないでください。
VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY
値: 0x100000
シャドウ コピーはローカルに公開されます。 このビット フラグとVSS_VOLSNAP_ATTR_EXPOSED_REMOTELY ビット フラグが
設定されていない場合、シャドウ コピーは非表示になります。


属性は、 を呼び出すとシャドウ コピー コンテキストに自動的に追加されます。
IVssBackupComponents::ExposeSnapshot
メソッドを使用してシャドウ コピーをローカルに公開します。

この属性は、シャドウ コピーのコンテキストを設定するときに、要求者が明示的に使用しないでください。
VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY
値: 0x200000
シャドウ コピーはリモートで公開されます。 このビット フラグとVSS_VOLSNAP_ATTR_EXPOSED_LOCALLY ビット フラグが
設定されていない場合、シャドウ コピーは非表示になります。


属性は、 を呼び出すとシャドウ コピー コンテキストに自動的に追加されます。
IVssBackupComponents::ExposeSnapshot
メソッドを使用してシャドウ コピーをローカルに公開します。

この属性は、シャドウ コピーのコンテキストを設定するときに、要求者が明示的に使用しないでください。
VSS_VOLSNAP_ATTR_AUTORECOVER
値: 0x400000
ライターが CSVsWriter::OnPostSnapshot でコンポーネントを自動回復する必要があることを示します。

この属性は、シャドウ コピーのコンテキストを設定するときに、要求者が明示的に使用しないでください。
VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY
値: 0x800000
シャドウ コピーがロールバックに使用されている場合 (データ マイニングの場合など)、ライターが CVssWriter::OnPostSnapshot でコンポーネントを自動回復する必要があることを示します。

リクエスターは、シャドウ コピー コンテキストでこのフラグを設定して、データ マイニングなどの非バックアップ目的でシャドウ コピーが作成されていることを示します。
VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT
値: 0x1000000
システムで使用するために予約されています。

Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 までサポートされていません。
VSS_VOLSNAP_ATTR_TXF_RECOVERY
値: 0x2000000
シャドウ コピーの作成時に TxF 回復を適用する必要があることを示します。

Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 までサポートされていません。
VSS_VOLSNAP_ATTR_FILE_SHARE
値: 0x4000000

解説

VSS シャドウ コピーの既定のコンテキストはVSS_CTX_BACKUP。

要求者は、 _VSS_SNAPSHOT_CONTEXT 列挙体のメンバーを IVssBackupComponents::SetContext メソッドに渡すことによって、作成されるシャドウ コピーのコンテキストを設定します。

要求者は、IVssBackupComponents::SetContext の引数として、_VSS_VOLUME_SNAPSHOT_ATTRIBUTES 列挙体からサポートされている値を持つ_VSS_SNAPSHOT_CONTEXT値のビットごとの OR を使用して、このコンテキストを変更できます。

特定のメカニズムのサポートを特に要求しない限り、プロバイダーは任意の種類のメカニズムを自由に使用してシャドウ コピーを実装できます。 したがって、シャドウ コピー方法が指定されていない場合、プロバイダーは、差分メカニズム (VSS_VOLSNAP_ATTR_DIFFERENTIAL)、PLEX メカニズム (VSS_VOLSNAP_ATTR_PLEX)、またはシャドウ コピーをサポートするその他のメカニズムを自由に選択できます。

プロバイダーは両方のメカニズムをサポートできますが、特定のシャドウ コピーでは相互に排他的です。 要求者は、特定のシャドウ コピー コンテキスト を 変更するために 、VSS_VOLSNAP_ATTR_DIFFERENTIALとVSS_VOLSNAP_ATTR_PLEX の両方を使用しないでください。

現在、 VSS_VOLSNAP_ATTR_DIFFERENTIAL、 VSS_VOLSNAP_ATTR_PLEX、 およびVSS_VOLSNAP_ATTR_TRANSPORTABLE は、任意のコンテキストの変更に使用できる _VSS_VOLUME_SNAPSHOT_ATTRIBUTES 列挙体の唯一の値です。

また、 VSS_CTX_CLIENT_ACCESSIBLE コンテキストの変更には使用できません。

リクエスターは、IVssBackupComponents::GetSnapshotProperties の呼び出しによって返されるVSS_OBJECT_PROP構造体からVSS_SNAPSHOT_PROP構造体を開梱することで、特定のシャドウ コピー (VSS_IDによって識別される) に関する情報を取得できます。

リクエスターは、IVssBackupComponents::Query を呼び出し、IVssEnumObject を使用して戻り値を反復処理することで、複数のシャドウ コピーごとにVSS_SNAPSHOT_PROP構造を取得することもできます。

シャドウ コピーのコンテキストと属性は、VSS_SNAPSHOT_PROP構造体のm_lSnapshotAttributes メンバーに含まれるビット マスクとして見つかります。

要件

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

関連項目

IVssBackupComponents::D eleteSnapshots

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::ExposeSnapshot

IVssBackupComponents::GetSnapshotProperties

IVssBackupComponents::ImportSnapshots

IVssBackupComponents::SetContext

VSS_OBJECT_PROP

VSS_SNAPSHOT_PROP

_VSS_SNAPSHOT_CONTEXT