struktur VSS_SNAPSHOT_PROP (vss.h)

Artikel
08/27/2023

Struktur VSS_SNAPSHOT_PROP berisi properti salinan bayangan atau set salinan bayangan.

Sintaks

typedef struct _VSS_SNAPSHOT_PROP {
  VSS_ID             m_SnapshotId;
  VSS_ID             m_SnapshotSetId;
  LONG               m_lSnapshotsCount;
  VSS_PWSZ           m_pwszSnapshotDeviceObject;
  VSS_PWSZ           m_pwszOriginalVolumeName;
  VSS_PWSZ           m_pwszOriginatingMachine;
  VSS_PWSZ           m_pwszServiceMachine;
  VSS_PWSZ           m_pwszExposedName;
  VSS_PWSZ           m_pwszExposedPath;
  VSS_ID             m_ProviderId;
  LONG               m_lSnapshotAttributes;
  VSS_TIMESTAMP      m_tsCreationTimestamp;
  VSS_SNAPSHOT_STATE m_eStatus;
} VSS_SNAPSHOT_PROP, *PVSS_SNAPSHOT_PROP;

Anggota

m_SnapshotId

VSS_ID (GUID) secara unik mengidentifikasi pengidentifikasi salinan bayangan.

m_SnapshotSetId

VSS_ID (GUID) secara unik mengidentifikasi set salinan bayangan yang berisi salinan bayangan.

m_lSnapshotsCount

Jumlah volume yang disertakan dengan salinan bayangan dalam set salinan bayangan saat dibuat. Karena dimungkinkan bagi aplikasi untuk merilis salinan bayangan individu tanpa melepaskan set salinan bayangan, pada waktu tertentu jumlah salinan bayangan dalam set salinan bayangan mungkin kurang dari m_LSnapshotsCount.

Jumlah maksimum volume yang disalin bayangan yang diizinkan dalam set salinan bayangan adalah 64.

m_pwszSnapshotDeviceObject

String karakter lebar yang dihentikan null yang berisi nama objek perangkat untuk salinan bayangan volume. Objek perangkat dapat dianggap sebagai akar salinan bayangan volume. Pemohon akan menggunakan nama perangkat ini saat mengakses file pada volume yang disalin bayangan yang perlu dikerjakan.

Nama perangkat tidak berisi "" berikutnya.

m_pwszOriginalVolumeName

String karakter lebar yang dihentikan null berisi nama volume yang telah disalin bayangan.

m_pwszOriginatingMachine

String karakter lebar yang dihentikan null yang berisi nama komputer yang berisi volume asli.

m_pwszServiceMachine

String karakter lebar yang dihentikan null yang berisi nama komputer yang menjalankan Layanan Menyalin Bayangan Volume yang membuat salinan bayangan.

m_pwszExposedName

String karakter lebar yang dihentikan null yang berisi nama salinan bayangan saat diekspos. Ini adalah huruf kandar atau folder yang dipasang (jika salinan bayangan diekspos sebagai volume lokal), atau nama berbagi. Sesuai dengan parameter wszExpose dari metode IVssBackupComponents::ExposeSnapshot .

m_pwszExposedPath

String karakter lebar yang dihentikan null yang menunjukkan bagian salinan bayangan volume yang tersedia jika diekspos sebagai berbagi. Sesuai dengan parameter wszPathFromRoot dari metode IVssBackupComponents::ExposeSnapshot .

m_ProviderId

VSS_ID (GUID) secara unik mengidentifikasi penyedia yang digunakan untuk membuat salinan bayangan ini.

m_lSnapshotAttributes

Atribut salinan bayangan yang dinyatakan sebagai masker bit (atau bitwise OR) dari anggota enumerasi _VSS_VOLUME_SNAPSHOT_ATTRIBUTES .

m_tsCreationTimestamp

Stempel waktu yang menunjukkan kapan salinan bayangan dibuat. Waktu yang tepat ditentukan oleh penyedia. Lihat VSS_TIMESTAMP untuk informasi tentang format stempel waktu.

m_eStatus

Status pembuatan salinan bayangan saat ini. Lihat VSS_SNAPSHOT_STATE.

Keterangan

Pemohon biasanya mendapatkan penunjuk ke struktur VSS_SNAPSHOT_PROP dengan menggunakan metode IVssBackupComponents::GetSnapshotProperties atau metode IVssSoftwareSnapshotProvider::GetSnapshotProperties . Ketika struktur ini tidak lagi diperlukan, pemanggil bertanggung jawab untuk membebaskannya dengan menggunakan fungsi VssFreeSnapshotProperties .

Objek perangkat salinan bayangan yang terkandung dalam m_pwszSnapshotDeviceObject digunakan untuk mengatasi file pada salinan bayangan volume. Misalnya, jika volume asli memiliki file dengan jalur "\topleveldir\File.html", maka jalur ke salinan bayangan file adalah "m_pwszSnapshotDeviceObject"+"\topleveldir\File.html".

Ketika salinan bayangan diekspos sebagai berbagi, nilai m_pwszExposedName akan menjadi nama berbagi. Ketika salinan bayangan diekspos sebagai huruf kandar atau folder yang dipasang, salinan bayangan m_pwszExposedName adalah huruf kandar diikuti oleh titik dua—misalnya, "X:" atau jalur folder yang dipasang (misalnya, "Y:\MountX").

Jika salinan bayangan diekspos sebagai huruf drive atau folder yang dipasang, maka (seperti halnya memasang perangkat apa pun) seluruh salinan bayangan yang dimulai di akarnya akan diekspos pada titik pemasangan. Dalam hal ini, m_pwszExposedPath akan null.

Jika salinan bayangan diekspos sebagai berbagi, nilai m_pwszExposedPath akan menjadi jalur ke bagian volume yang dibagikan.

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