Bagikan melalui


enumerasi VSS_VOLUME_SNAPSHOT_ATTRIBUTES (vss.h)

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

Lihat juga

IVssBackupComponents::D eleteSnapshots

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::ExposeSnapshot

IVssBackupComponents::GetSnapshotProperties

IVssBackupComponents::ImportSnapshots

IVssBackupComponents::SetContext

VSS_OBJECT_PROP

VSS_SNAPSHOT_PROP

_VSS_SNAPSHOT_CONTEXT