enumerasi VSS_SNAPSHOT_CONTEXT (vss.h)

Artikel
08/27/2023

Enumerasi _VSS_SNAPSHOT_CONTEXT memungkinkan pemohon menggunakan IVssBackupComponents::SetContext untuk menentukan bagaimana salinan bayangan akan dibuat, dikueri, atau dihapus dan tingkat keterlibatan penulis.

Sintaks

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;

Konstanta


`VSS_CTX_BACKUP` Nilai: 0 Konteks pencadangan standar. Menentukan penyalinan bayangan otomatis yang tidak konsisten di mana penulis berada yang terlibat dalam pembuatan.
`VSS_CTX_FILE_SHARE_BACKUP` Menentukan penyalinan bayangan otomatis yang tidak konsisten yang dibuat tanpa keterlibatan penulis.
`VSS_CTX_NAS_ROLLBACK` Menentukan salinan bayangan rilis non-otomatis yang persisten tanpa keterlibatan penulis. Konteks ini harus digunakan ketika tidak perlu keterlibatan penulis untuk memastikan bahwa file dalam keadaan konsisten pada saat itu salinan bayangan. Mekanisme putar kembali file otomatis yang ringan atau salinan bayangan persisten dari berbagi file atau volume data yang tidak diharapkan berisi file atau database terkait sistem yang mungkin berjalan di bawah konteks ini. Untuk misalnya, pemohon dapat menggunakan konteks ini untuk membuat salinan bayangan dokumen hosting volume NAS dan berbagi pengguna sederhana. Jenis data tersebut tidak memerlukan keterlibatan penulis untuk membuat salinan bayangan yang konsisten.
`VSS_CTX_APP_ROLLBACK` Menentukan salinan bayangan rilis non-otomatis yang persisten dengan keterlibatan penulis. Konteks ini dirancang untuk digunakan ketika penulis diperlukan untuk memastikan bahwa file dalam keadaan terdefinisi dengan baik sebelum salinan bayangan. Mekanisme putar kembali file otomatis volume sistem dan salinan bayangan yang akan digunakan dalam penggalian atau pemulihan data operasi mungkin berjalan di bawah konteks ini. Konteks ini mirip dengan VSS_CTX_BACKUP tetapi memungkinkan pemohon lebih mengontrol kegigihan salinan bayangan.
`VSS_CTX_CLIENT_ACCESSIBLE` Menentukan salinan bayangan baca-saja yang dapat diakses klien yang mendukung Salinan Bayangan untuk Folder Bersama dan dibuat tanpa keterlibatan penulis. Hanya penyedia sistem (penyedia default yang tersedia pada sistem) yang dapat membuat jenis salinan bayangan ini. Sebagian besar pemohon akan ingin menggunakan konteks VSS_CTX_NAS_ROLLBACK untuk salinan bayangan persisten dan non-rilis otomatis tanpa keterlibatan penulis.
`VSS_CTX_CLIENT_ACCESSIBLE_WRITERS` Menentukan salinan bayangan baca-saja yang dapat diakses klien yang dibuat dengan keterlibatan penulis. Hanya penyedia sistem (penyedia default yang tersedia pada sistem) yang dapat membuat jenis salinan bayangan ini. Sebagian besar pemohon akan ingin menggunakan konteks VSS_CTX_APP_ROLLBACK untuk salinan bayangan persisten dan non-rilis otomatis dengan keterlibatan penulis. Windows Server 2003 dan Windows XP: Konteks ini tidak didukung oleh Windows Server 2003 dan Windows XP.
`VSS_CTX_ALL` Nilai: 0xffffffff Semua jenis salinan bayangan langsung saat ini tersedia untuk operasi administratif, seperti salinan bayangan kueri (lihat IVssBackupComponents::Query). VSS_CTX_ALL adalah konteks yang valid untuk semua antarmuka VSS kecuali IVssBackupComponents::StartSnapshotSet dan IVssBackupComponents::D oSnapshotSet.

Keterangan

Jenis data yang akan digunakan dengan nilai _VSS_SNAPSHOT_CONTEXT adalah LONG.

Konteks default untuk salinan bayangan VSS adalah VSS_CTX_BACKUP.

Windows XP: Satu-satunya konteks yang didukung adalah default, VSS_CTX_BACKUP. Memanggil IVssBackupComponents::SetContext akan mengembalikan E_NOTIMPL.

Untuk detail tentang cara menggunakan konteks salinan bayangan VSS, lihat Detail Implementasi untuk Membuat Salinan Bayangan.

Perilaku salinan bayangan dapat dikontrol lebih lanjut dengan menggunakan bitwise OR untuk menggabungkan _VSS_VOLUME_SNAPSHOT_ATTRIBUTES yang didukung dengan nilai _VSS_SNAPSHOT_CONTEXT yang valid sebagai argumen ke metode IVssBackupComponents::SetContext .

Saat ini, satu-satunya modifikasi yang didukung adalah bitwise ATAU dari nilai _VSS_SNAPSHOT_CONTEXT dengan VSS_VOLSNAP_ATTR_TRANSPORTABLE dan nilai VSS_VOLSNAP_ATTR_DIFFERENTIAL atau VSS_VOLSNAP_ATTR_PLEX enumerasi _VSS_VOLUME_SNAPSHOT_ATTRIBUTES .

Namun, nilai-nilai ini tidak dapat digunakan untuk memodifikasi konteks VSS_CTX_CLIENT_ACCESSIBLE .

Penggunaan VSS_VOLSNAP_ATTR_TRANSPORTABLE terbatas pada sistem yang menjalankan Windows Server 2008 Enterprise, Windows Server 2008 Datacenter, Windows Server 2003, Enterprise Edition, atau Windows Server 2003, Datacenter Edition.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	vss.h

Lihat juga

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::ExposeSnapshot

IVssBackupComponents::SetContext

VSS_OBJECT_PROP

VSS_SNAPSHOT_PROP

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES

Bagikan melalui