enumerasi VSS_VOLUME_SNAPSHOT_ATTRIBUTES (vss.h)

Artikel
08/27/2023

Memungkinkan atribut tambahan ditentukan untuk salinan bayangan. Konteks salinan bayangan (sebagaimana diatur oleh metode IVssBackupComponents::SetContext ) dapat dimodifikasi oleh bitmask yang berisi kombinasi nilai enumerasi _VSS_VOLUME_SNAPSHOT_ATTRIBUTES dan _VSS_SNAPSHOT_CONTEXT yang valid.

Sintaks

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;

Konstanta


`VSS_VOLSNAP_ATTR_PERSISTENT` Nilai: 0x1 Salinan bayangan persisten di seluruh reboot. Atribut ini secara otomatis diatur untuk _VSS_SNAPSHOT_CONTEXT konteks VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS, dan VSS_CTX_NAS_ROLLBACK. Atribut ini tidak boleh digunakan secara eksplisit oleh pemohon saat mengatur konteks salinan bayangan.
`VSS_VOLSNAP_ATTR_NO_AUTORECOVERY` Nilai: 0x2 Pemulihan otomatis dinonaktifkan untuk salinan bayangan. Pemohon dapat mengubah konteks salinan bayangan dengan bitwise ATAU atribut ini. Dengan melakukan ini, pemohon menginstruksikan VSS untuk membuat salinan bayangan baca-saja segera setelah dibuat, tanpa mengizinkan penulis atau aplikasi lain untuk memperbarui komponen dalam salinan bayangan. Menonaktifkan pemulihan otomatis dapat menyebabkan salinan bayangan berada dalam keadaan tidak konsisten jika salah satu komponennya terlibat dalam operasi database transaksional, seperti operasi baca dan tulis transaksional yang dikelola oleh Transactional NTFS (TxF). Ini karena menonaktifkan pemulihan otomatis mencegah transaksi yang tidak lengkap digulung balik. Menonaktifkan pemulihan otomatis juga mencegah penulis mengecualikan file dari salinan bayangan. Ketika pemulihan otomatis dinonaktifkan, penulis masih dapat memanggil metode IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot , tetapi metode CVssWriter penulis::OnPostSnapshot tidak dapat menghapus file dari salinan bayangan. Windows Server 2003 dan Windows XP: Nilai ini tidak didukung sampai Windows Vista.
`VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE` Nilai: 0x4 Salinan bayangan yang ditentukan adalah salinan bayangan yang dapat diakses klien yang mendukung Salinan Bayangan untuk Folder Bersama, dan tidak boleh diekspos. Atribut ini secara otomatis diatur untuk VSS_CTX_CLIENT_ACCESSIBLE dan VSS_CTX_CLIENT_ACCESSIBLE_WRITERS. Atribut ini tidak boleh digunakan secara eksplisit oleh pemohon saat mengatur konteks salinan bayangan.
`VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE` Nilai: 0x8 Salinan bayangan tidak dihapus secara otomatis saat proses pemohon salinan bayangan berakhir. Salinan bayangan hanya dapat dihapus dengan panggilan ke IVssBackupComponents::D eleteSnapshots. Atribut ini secara otomatis diatur untuk _VSS_SNAPSHOT_CONTEXT konteks VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS, dan VSS_CTX_NAS_ROLLBACK. Atribut ini tidak boleh digunakan secara eksplisit oleh pemohon saat mengatur konteks salinan bayangan.
`VSS_VOLSNAP_ATTR_NO_WRITERS` Nilai: 0x10 Tidak ada penulis yang terlibat dalam pembuatan salinan bayangan. Atribut ini secara otomatis diatur untuk _VSS_SNAPSHOT_CONTEXT konteks VSS_CTX_NAS_ROLLBACK, VSS_CTX_FILE_SHARE_BACKUP, dan VSS_CTX_CLIENT_ACCESSIBLE. Atribut ini tidak boleh digunakan secara eksplisit oleh pemohon saat mengatur konteks salinan bayangan.
`VSS_VOLSNAP_ATTR_TRANSPORTABLE` Nilai: 0x20 Salinan bayangan akan diangkut dan oleh karena itu tidak boleh muncul secara lokal. Atribut ini dapat digunakan secara eksplisit oleh pemohon saat mengatur konteks salinan bayangan, jika penyedia untuk salinan bayangan mendukung salinan bayangan yang dapat diangkut. Windows Server 2003, Standard Edition, Windows Server 2003, Web Edition, dan Windows XP: Atribut ini tidak didukung. Semua edisi Windows Server 2003 dengan SP1 mendukung atribut ini. Lihat Mengimpor Yang Dapat Diangkut Volume Yang Disalin Bayangan untuk informasi selengkapnya.
`VSS_VOLSNAP_ATTR_NOT_SURFACED` Nilai: 0x40 Salinan bayangan saat ini tidak terekspos. Kecuali salinan bayangan secara eksplisit diekspos atau dipasang, atribut ini diatur untuk semua salinan bayangan. Atribut ini tidak boleh digunakan secara eksplisit oleh pemohon saat mengatur konteks salinan bayangan.
`VSS_VOLSNAP_ATTR_NOT_TRANSACTED` Nilai: 0x80 Salinan bayangan tidak ditransaksikan. Pemohon dapat mengubah konteks salinan bayangan dengan bitwise ATAU atribut ini. Dengan melakukan ini, pemohon menginstruksikan VSS untuk menonaktifkan integrasi bawaan antara VSS dan manajer transaksi dan sumber daya. Mengatur atribut ini menjamin bahwa pemohon tidak akan menerima kesalahan VSS_E_TRANSACTION_FREEZE_TIMEOUT. Namun, hal ini dapat menyebabkan konsekuensi yang tidak diinginkan, seperti hilangnya integritas transaksi atau bahkan kehilangan data. Windows Server 2003 dan Windows XP: Nilai ini tidak didukung sampai Windows Vista.
`VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED` Nilai: 0x10000 Menunjukkan bahwa penyedia tertentu adalah penyedia perangkat keras. Atribut ini secara otomatis diatur untuk penyedia perangkat keras. Nilai enumerasi ini tidak dapat digunakan untuk mengatur konteks secara manual (menggunakan IVssBackupComponents::SetContext metode) salinan bayangan dengan masker bit (atau bitwise OR) dari nilai enumerasi ini dan salinan bayangan yang valid nilai konteks dari _VSS_SNAPSHOT_CONTEXT.
`VSS_VOLSNAP_ATTR_DIFFERENTIAL` Nilai: 0x20000 Menunjukkan bahwa penyedia tertentu menggunakan data diferensial atau mekanisme copy-on-write untuk mengimplementasikan salinan bayangan. Pemohon dapat mengubah konteks salinan bayangan dengan bitwise ATAU atribut ini. Dengan melakukan ini, pemohon menginstruksikan penyedia untuk membuat salinan bayangan menggunakan implementasi diferensial. Jika tidak ada salinan bayangan penyedia yang diinstal pada sistem mendukung atribut yang diminta, kesalahan VSS_E_VOLUME_NOT_SUPPORTED akan dikembalikan ke IVssBackupComponents::AddToSnapshotSet.
`VSS_VOLSNAP_ATTR_PLEX` Nilai: 0x40000 Menunjukkan bahwa penyedia tertentu menggunakan mekanisme pemisahan PLEX atau cermin untuk mengimplementasikan salinan bayangan. Pemohon dapat mengubah konteks salinan bayangan dengan bitwise ATAU atribut ini. Dengan melakukan ini, pemohon menginstruksikan penyedia untuk membuat salinan bayangan menggunakan implementasi PLEX. Jika tidak ada salinan bayangan penyedia yang diinstal pada sistem mendukung atribut yang diminta, kesalahan VSS_E_VOLUME_NOT_SUPPORTED akan dikembalikan ke IVssBackupComponents::AddToSnapshotSet.
`VSS_VOLSNAP_ATTR_IMPORTED` Nilai: 0x80000 Salinan bayangan volume diimpor ke komputer ini menggunakan IVssBackupComponents::ImportSnapshots metode daripada dibuat menggunakan IVssBackupComponents::D oSnapshotSet metode. Atribut ini secara otomatis diatur jika salinan bayangan diimpor. Atribut ini tidak boleh digunakan secara eksplisit oleh pemohon saat mengatur konteks salinan bayangan.
`VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY` Nilai: 0x100000 Salinan bayangan diekspos secara lokal. Jika bendera bit ini dan bendera bit VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY adalah tidak diatur, salinan bayangan disembunyikan. Atribut secara otomatis ditambahkan ke konteks salinan bayangan saat memanggil IVssBackupComponents::ExposeSnapshot metode untuk mengekspos salinan bayangan secara lokal. Atribut ini tidak boleh digunakan secara eksplisit oleh pemohon saat mengatur konteks salinan bayangan.
`VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY` Nilai: 0x200000 Salinan bayangan terekspos dari jarak jauh. Jika bendera bit ini dan bendera bit VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY adalah tidak diatur, salinan bayangan disembunyikan. Atribut secara otomatis ditambahkan ke konteks salinan bayangan saat memanggil IVssBackupComponents::ExposeSnapshot metode untuk mengekspos salinan bayangan secara lokal. Atribut ini tidak boleh digunakan secara eksplisit oleh pemohon saat mengatur konteks salinan bayangan.
`VSS_VOLSNAP_ATTR_AUTORECOVER` Nilai: 0x400000 Menunjukkan bahwa penulis perlu memulihkan komponen secara otomatis di CVssWriter::OnPostSnapshot. Atribut ini tidak boleh digunakan secara eksplisit oleh pemohon saat mengatur konteks salinan bayangan.
`VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY` Nilai: 0x800000 Menunjukkan bahwa penulis perlu memulihkan komponen secara otomatis di CVssWriter::OnPostSnapshot jika salinan bayangan digunakan untuk pemutaran kembali (misalnya untuk penambangan data). Pemohon akan mengatur bendera ini dalam konteks salinan bayangan untuk menunjukkan bahwa salinan bayangan sedang dibuat untuk tujuan non-cadangan seperti penggalian data.
`VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT` Nilai: 0x1000000 Dicadangkan untuk penggunaan sistem. Windows Vista, Windows Server 2003, dan Windows XP: Nilai ini tidak didukung sampai Windows Server 2008.
`VSS_VOLSNAP_ATTR_TXF_RECOVERY` Nilai: 0x2000000 Menunjukkan bahwa pemulihan TxF harus diberlakukan selama pembuatan salinan bayangan. Windows Vista, Windows Server 2003, dan Windows XP: Nilai ini tidak didukung sampai Windows Server 2008.
`VSS_VOLSNAP_ATTR_FILE_SHARE` Nilai: 0x4000000

Keterangan

Konteks default untuk salinan bayangan VSS adalah VSS_CTX_BACKUP.

Pemohon mengatur konteks untuk salinan bayangan yang akan dibuat dengan meneruskan anggota enumerasi _VSS_SNAPSHOT_CONTEXT ke metode IVssBackupComponents::SetContext .

Pemohon dapat mengubah konteks ini dengan menggunakan bitwise OR dari nilai _VSS_SNAPSHOT_CONTEXT dengan nilai yang didukung dari enumerasi _VSS_VOLUME_SNAPSHOT_ATTRIBUTES sebagai argumen ke IVssBackupComponents::SetContext.

Kecuali secara khusus diminta untuk mendukung mekanisme tertentu, penyedia bebas menggunakan semua jenis mekanisme untuk mengimplementasikan salinan bayangan. Oleh karena itu, dalam kasus di mana metode salinan bayangan tidak ditentukan, penyedia bebas untuk memilih mekanisme diferensial (VSS_VOLSNAP_ATTR_DIFFERENTIAL), mekanisme PLEX (VSS_VOLSNAP_ATTR_PLEX), atau mekanisme lain untuk mendukung salinan bayangan.

Meskipun penyedia dapat mendukung kedua mekanisme, mereka saling eksklusif untuk salinan bayangan tertentu. Pemohon tidak boleh menggunakan VSS_VOLSNAP_ATTR_DIFFERENTIAL dan VSS_VOLSNAP_ATTR_PLEX untuk memodifikasi konteks salinan bayangan tertentu.

Saat ini, VSS_VOLSNAP_ATTR_DIFFERENTIAL, VSS_VOLSNAP_ATTR_PLEX, dan VSS_VOLSNAP_ATTR_TRANSPORTABLE adalah satu-satunya nilai enumerasi _VSS_VOLUME_SNAPSHOT_ATTRIBUTES yang dapat digunakan untuk memodifikasi konteks apa pun.

Selain itu, ini tidak dapat digunakan untuk memodifikasi konteks VSS_CTX_CLIENT_ACCESSIBLE .

Pemohon dapat memperoleh informasi tentang salinan bayangan tertentu (diidentifikasi oleh VSS_ID) dengan membuka struktur VSS_SNAPSHOT_PROP dari struktur VSS_OBJECT_PROP yang dikembalikan oleh panggilan ke IVssBackupComponents::GetSnapshotProperties.

Pemohon juga dapat memperoleh struktur VSS_SNAPSHOT_PROP untuk setiap salinan bayangan dengan memanggil IVssBackupComponents::Query dan menggunakan IVssEnumObject untuk melakukan iterasi pengembalian.

Konteks dan atribut salinan bayangan ditemukan sebagai masker bit yang terkandung dalam anggota m_lSnapshotAttributes struktur VSS_SNAPSHOT_PROP .

Persyaratan


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