VSS_SNAPSHOT_CONTEXT列挙 (vss.h)

  • [アーティクル]

_VSS_SNAPSHOT_CONTEXT列挙を使用すると、IVssBackupComponents::SetContext を使用して、シャドウ コピーを作成、照会、または削除する方法とライターの関与の程度を指定できます。

構文

typedef enum _VSS_SNAPSHOT_CONTEXT {
  VSS_CTX_BACKUP = 0,
  VSS_CTX_FILE_SHARE_BACKUP,
  VSS_CTX_NAS_ROLLBACK,
  VSS_CTX_APP_ROLLBACK,
  VSS_CTX_CLIENT_ACCESSIBLE,
  VSS_CTX_CLIENT_ACCESSIBLE_WRITERS,
  VSS_CTX_ALL = 0xffffffff
} VSS_SNAPSHOT_CONTEXT, *PVSS_SNAPSHOT_CONTEXT;

定数

 
VSS_CTX_BACKUP
値: 0
標準のバックアップ コンテキスト。 ライターが存在する自動リリースの非永続シャドウ コピーを指定します。
作成に関連する。
VSS_CTX_FILE_SHARE_BACKUP
ライターの関与なしに作成された自動リリースの非永続シャドウ コピーを指定します。
VSS_CTX_NAS_ROLLBACK
書き込み機能を使用せずに、非自動リリースの永続的なシャドウ コピーを指定します。 このコンテキストは、
ファイルが一貫した状態であることを確認するためにライターの関与が必要ない場合に使用されます
シャドウ コピーの 。


軽量の自動ファイル ロールバック メカニズムまたはファイル共有またはデータ ボリュームの永続的なシャドウ コピー
システム関連のファイルまたはデータベースが含まれていない場合は、このコンテキストで実行される可能性があります。 For
たとえば、リクエスターは、このコンテキストを使用して、ドキュメントをホストする NAS ボリュームのシャドウ コピーを作成し、
単純なユーザー共有。 これらの種類のデータでは、一貫性のあるシャドウ コピーを作成するためにライターの関与は必要ありません。
VSS_CTX_APP_ROLLBACK
ライターが関与する永続的な自動解放以外のシャドウ コピーを指定します。 このコンテキストは設計されています
は、シャドウ コピーの前にファイルが明確に定義された状態であることを確認するためにライターが必要な場合に使用されます。


データ マイニングまたは復元で使用されるシステム ボリュームとシャドウ コピーの自動ファイル ロールバック メカニズム
操作は、このコンテキストで実行される可能性があります。 このコンテキストは 、VSS_CTX_BACKUP
ただし、要求者はシャドウ コピーの永続化をより詳細に制御できます。
VSS_CTX_CLIENT_ACCESSIBLE
共有フォルダーのシャドウ コピーをサポートし、ライターの関与なしに作成される、 クライアントがアクセスできる 読み取り専用のシャドウ コピーを指定します。 この種類のシャドウ コピーを作成できるのは、システム プロバイダー (システムで使用できる既定のプロバイダー) のみです。

ほとんどの要求者は、ライターの関与なしに、永続的な自動リリース以外のシャドウ コピーに 対 してVSS_CTX_NAS_ROLLBACK コンテキストを使用する必要があります。
VSS_CTX_CLIENT_ACCESSIBLE_WRITERS
ライターが関与して作成される、 クライアントがアクセスできる 読み取り専用のシャドウ コピーを指定します。 この種類のシャドウ コピーを作成できるのは、システム プロバイダー (システムで使用できる既定のプロバイダー) のみです。

ほとんどの要求者は、ライターが関与する永続的で自動解放されていないシャドウ コピーに対して、 VSS_CTX_APP_ROLLBACK コンテキストを使用する必要があります。

Windows Server 2003 および Windows XP: このコンテキストは、Windows Server 2003 および Windows XP ではサポートされていません。
VSS_CTX_ALL
値: 0xffffffff
現在ライブ シャドウ コピーのすべての種類は、シャドウ コピーなどの管理操作で使用できます
クエリ ( 「IVssBackupComponents::Query」を参照)。
VSS_CTX_ALL は、 を除くすべての VSS インターフェイスに対して有効なコンテキストです
IVssBackupComponents::StartSnapshotSet
および
IVssBackupComponents::D oSnapshotSet。

注釈

_VSS_SNAPSHOT_CONTEXTの値と共に使用するデータ型は LONG です。

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

Windows XP: サポートされているコンテキストは、既定の VSS_CTX_BACKUPのみです。 IVssBackupComponents::SetContext を呼び出すと、E_NOTIMPLが返されます。

VSS シャドウ コピー コンテキストの使用方法の詳細については、「シャドウ コピーの 作成に関する実装の詳細」を参照してください。

シャドウ コピーの動作をさらに制御するには、ビットごとの OR を使用して、サポートされている _VSS_VOLUME_SNAPSHOT_ATTRIBUTES と有効な _VSS_SNAPSHOT_CONTEXT 値を IVssBackupComponents::SetContext メソッドの引数として組み合わせます。

現在サポートされている変更は、VSS_VOLSNAP_ATTR_TRANSPORTABLEを持つ_VSS_SNAPSHOT_CONTEXT値のビットごとの OR と、_VSS_VOLUME_SNAPSHOT_ATTRIBUTES列挙のVSS_VOLSNAP_ATTR_DIFFERENTIALまたはVSS_VOLSNAP_ATTR_PLEX値のみです。

ただし、これらの値を使用して コンテキストVSS_CTX_CLIENT_ACCESSIBLE 変更することはできません。

VSS_VOLSNAP_ATTR_TRANSPORTABLEの使用は、Windows Server 2008 Enterprise、Windows Server 2008 Datacenter、Windows Server 2003、Enterprise Edition、または Windows Server 2003 Datacenter Edition を実行しているシステムに限定されます。

要件

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

こちらもご覧ください

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::ExposeSnapshot

IVssBackupComponents::SetContext

VSS_OBJECT_PROP

VSS_SNAPSHOT_PROP

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES