ホーム › Storage.Vss › VSS_SNAPSHOT_CONTEXT

VSS_SNAPSHOT_CONTEXT

列挙型

基底型i4

メンバー 7

名前	10進	16進	説明
VSS_CTX_BACKUP	0	0x0	標準のバックアップコンテキストです。作成時にライターが関与する、自動解放される非永続的なシャドウコピーを指定します。
VSS_CTX_FILE_SHARE_BACKUP	16	0x10	ライターの関与なしで作成される、自動解放される非永続的なシャドウコピーを指定します。
VSS_CTX_NAS_ROLLBACK	25	0x19	ライターの関与がない、永続的で自動解放されないシャドウコピーを指定します。このコンテキストは、シャドウコピーの時点でファイルが一貫した状態にあることを保証するためにライターの関与が必要ない場合に使用します。軽量な自動ファイルロールバック機構や、システム関連のファイルやデータベースを含まないと想定されるファイル共有またはデータボリュームの永続的なシャドウコピーは、このコンテキストで実行される可能性があります。たとえば、リクエスターはドキュメントや単純なユーザー共有をホストする NAS ボリュームのシャドウコピーを作成するためにこのコンテキストを使用できます。これらの種類のデータでは、一貫したシャドウコピーを作成するためにライターの関与は必要ありません。
VSS_CTX_APP_ROLLBACK	9	0x9	ライターが関与する、永続的で自動解放されないシャドウコピーを指定します。このコンテキストは、シャドウコピーの前にファイルが明確に定義された状態にあることを保証するためにライターが必要な場合に使用するように設計されています。システムボリュームの自動ファイルロールバック機構や、データマイニングまたは復元操作で使用されるシャドウコピーは、このコンテキストで実行される可能性があります。このコンテキストは VSS_CTX_BACKUP に似ていますが、リクエスターがシャドウコピーの永続性をより細かく制御できます。
VSS_CTX_CLIENT_ACCESSIBLE	29	0x1D	共有フォルダーのシャドウコピーをサポートし、ライターの関与なしで作成される読み取り専用のクライアントからアクセス可能なシャドウコピーを指定します。この種類のシャドウコピーを作成できるのは、システムプロバイダー (システムで既定で使用できるプロバイダー) のみです。ほとんどのリクエスターは、ライターの関与がない永続的で自動解放されないシャドウコピーには VSS_CTX_NAS_ROLLBACK コンテキストを使用することになります。
VSS_CTX_CLIENT_ACCESSIBLE_WRITERS	13	0xD	ライターが関与して作成される読み取り専用のクライアントからアクセス可能なシャドウコピーを指定します。この種類のシャドウコピーを作成できるのは、システムプロバイダー (システムで既定で使用できるプロバイダー) のみです。ほとんどのリクエスターは、ライターが関与する永続的で自動解放されないシャドウコピーには VSS_CTX_APP_ROLLBACK コンテキストを使用することになります。 Windows Server 2003 および Windows XP: このコンテキストは Windows Server 2003 および Windows XP ではサポートされていません。
VSS_CTX_ALL	-1	0xFFFFFFFF	現在有効なすべての種類のシャドウコピーが、シャドウコピーのクエリ (IVssBackupComponents::Query を参照) などの管理操作で使用できます。 VSS_CTX_ALL は、 IVssBackupComponents::StartSnapshotSet と IVssBackupComponents::DoSnapshotSet を除く、すべての VSS インターフェイスで有効なコンテキストです。

公式ドキュメント

_VSS_SNAPSHOT_CONTEXT 列挙型は、 IVssBackupComponents::SetContext を使用するリクエスターが、シャドウコピーをどのように作成、クエリ、または削除するか、およびライターの関与の度合いを指定できるようにします。

解説(Remarks)

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

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

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

VSS シャドウコピーのコンテキストの使用方法の詳細については、 Implementation Details for Creating Shadow Copies を参照してください。

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

現在サポートされている変更は、_VSS_SNAPSHOT_CONTEXT の値と、 _VSS_VOLUME_SNAPSHOT_ATTRIBUTES 列挙型の VSS_VOLSNAP_ATTR_TRANSPORTABLE および VSS_VOLSNAP_ATTR_DIFFERENTIAL または VSS_VOLSNAP_ATTR_PLEX のいずれかの値とのビット単位のOR のみです。

ただし、これらの値を使用して 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 を実行しているシステムに限られます。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_SNAPSHOT_CONTEXT : int {
    VSS_CTX_BACKUP = 0,
    VSS_CTX_FILE_SHARE_BACKUP = 16,
    VSS_CTX_NAS_ROLLBACK = 25,
    VSS_CTX_APP_ROLLBACK = 9,
    VSS_CTX_CLIENT_ACCESSIBLE = 29,
    VSS_CTX_CLIENT_ACCESSIBLE_WRITERS = 13,
    VSS_CTX_ALL = -1
} VSS_SNAPSHOT_CONTEXT;

public enum VSS_SNAPSHOT_CONTEXT : int
{
    VSS_CTX_BACKUP = 0,
    VSS_CTX_FILE_SHARE_BACKUP = 16,
    VSS_CTX_NAS_ROLLBACK = 25,
    VSS_CTX_APP_ROLLBACK = 9,
    VSS_CTX_CLIENT_ACCESSIBLE = 29,
    VSS_CTX_CLIENT_ACCESSIBLE_WRITERS = 13,
    VSS_CTX_ALL = -1,
}

Public Enum VSS_SNAPSHOT_CONTEXT As Integer
    VSS_CTX_BACKUP = 0
    VSS_CTX_FILE_SHARE_BACKUP = 16
    VSS_CTX_NAS_ROLLBACK = 25
    VSS_CTX_APP_ROLLBACK = 9
    VSS_CTX_CLIENT_ACCESSIBLE = 29
    VSS_CTX_CLIENT_ACCESSIBLE_WRITERS = 13
    VSS_CTX_ALL = -1
End Enum

import enum

class VSS_SNAPSHOT_CONTEXT(enum.IntEnum):
    VSS_CTX_BACKUP = 0
    VSS_CTX_FILE_SHARE_BACKUP = 16
    VSS_CTX_NAS_ROLLBACK = 25
    VSS_CTX_APP_ROLLBACK = 9
    VSS_CTX_CLIENT_ACCESSIBLE = 29
    VSS_CTX_CLIENT_ACCESSIBLE_WRITERS = 13
    VSS_CTX_ALL = -1

// VSS_SNAPSHOT_CONTEXT
pub const VSS_CTX_BACKUP: i32 = 0;
pub const VSS_CTX_FILE_SHARE_BACKUP: i32 = 16;
pub const VSS_CTX_NAS_ROLLBACK: i32 = 25;
pub const VSS_CTX_APP_ROLLBACK: i32 = 9;
pub const VSS_CTX_CLIENT_ACCESSIBLE: i32 = 29;
pub const VSS_CTX_CLIENT_ACCESSIBLE_WRITERS: i32 = 13;
pub const VSS_CTX_ALL: i32 = -1;

// VSS_SNAPSHOT_CONTEXT
const (
	VSS_CTX_BACKUP int32 = 0
	VSS_CTX_FILE_SHARE_BACKUP int32 = 16
	VSS_CTX_NAS_ROLLBACK int32 = 25
	VSS_CTX_APP_ROLLBACK int32 = 9
	VSS_CTX_CLIENT_ACCESSIBLE int32 = 29
	VSS_CTX_CLIENT_ACCESSIBLE_WRITERS int32 = 13
	VSS_CTX_ALL int32 = -1
)

const
  VSS_CTX_BACKUP = 0;
  VSS_CTX_FILE_SHARE_BACKUP = 16;
  VSS_CTX_NAS_ROLLBACK = 25;
  VSS_CTX_APP_ROLLBACK = 9;
  VSS_CTX_CLIENT_ACCESSIBLE = 29;
  VSS_CTX_CLIENT_ACCESSIBLE_WRITERS = 13;
  VSS_CTX_ALL = -1;

// VSS_SNAPSHOT_CONTEXT
pub const VSS_CTX_BACKUP: i32 = 0;
pub const VSS_CTX_FILE_SHARE_BACKUP: i32 = 16;
pub const VSS_CTX_NAS_ROLLBACK: i32 = 25;
pub const VSS_CTX_APP_ROLLBACK: i32 = 9;
pub const VSS_CTX_CLIENT_ACCESSIBLE: i32 = 29;
pub const VSS_CTX_CLIENT_ACCESSIBLE_WRITERS: i32 = 13;
pub const VSS_CTX_ALL: i32 = -1;

const
  VSS_CTX_BACKUP* = 0
  VSS_CTX_FILE_SHARE_BACKUP* = 16
  VSS_CTX_NAS_ROLLBACK* = 25
  VSS_CTX_APP_ROLLBACK* = 9
  VSS_CTX_CLIENT_ACCESSIBLE* = 29
  VSS_CTX_CLIENT_ACCESSIBLE_WRITERS* = 13
  VSS_CTX_ALL* = -1

enum VSS_SNAPSHOT_CONTEXT : int {
    VSS_CTX_BACKUP = 0,
    VSS_CTX_FILE_SHARE_BACKUP = 16,
    VSS_CTX_NAS_ROLLBACK = 25,
    VSS_CTX_APP_ROLLBACK = 9,
    VSS_CTX_CLIENT_ACCESSIBLE = 29,
    VSS_CTX_CLIENT_ACCESSIBLE_WRITERS = 13,
    VSS_CTX_ALL = -1,
}

#define global VSS_CTX_BACKUP                    0x0
#define global VSS_CTX_FILE_SHARE_BACKUP         0x10
#define global VSS_CTX_NAS_ROLLBACK              0x19
#define global VSS_CTX_APP_ROLLBACK              0x9
#define global VSS_CTX_CLIENT_ACCESSIBLE         0x1D
#define global VSS_CTX_CLIENT_ACCESSIBLE_WRITERS 0xD
#define global VSS_CTX_ALL                       0xFFFFFFFF