Metode IVssBackupComponents::GetSnapshotProperties (vsbackup.h)

Artikel
03/08/2023

Metode GetSnapshotProperties mendapatkan properti dari salinan bayangan yang ditentukan.

Sintaks

HRESULT GetSnapshotProperties(
  [in]  VSS_ID            SnapshotId,
  [out] VSS_SNAPSHOT_PROP *pProp
);

Parameter

[in] SnapshotId

Pengidentifikasi salinan bayangan volume sebagaimana dikembalikan oleh IVssBackupComponents::AddToSnapshotSet.

[out] pProp

Alamat struktur VSS_SNAPSHOT_PROP yang dialokasikan pemanggil yang menerima properti salinan bayangan. Penyedia perangkat lunak bertanggung jawab untuk mengatur anggota struktur ini. Penyedia perangkat lunak mengalokasikan memori untuk semua anggota string yang ditetapkannya dalam struktur. Ketika struktur tidak lagi diperlukan, penyedia perangkat lunak bertanggung jawab untuk membebaskan string ini dengan memanggil fungsi VssFreeSnapshotProperties .

Mengembalikan nilai

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai	Makna
S_OK	Berhasil mengembalikan properti salinan bayangan.
E_ACCESSDENIED	Pemanggil tidak memiliki hak pencadangan yang memadai atau bukan administrator.
E_INVALIDARG	Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY	Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_BAD_STATE	Objek komponen cadangan tidak diinisialisasi, metode ini telah dipanggil selama operasi pemulihan, atau metode ini belum dipanggil dalam urutan yang benar.
VSS_E_OBJECT_NOT_FOUND	Salinan bayangan yang ditentukan tidak ada.
VSS_E_PROVIDER_VETO	Kesalahan penyedia yang diharapkan. Penyedia mencatat kesalahan dalam log peristiwa. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.
VSS_E_UNEXPECTED	Kesalahan tak terduga. Kode kesalahan dicatat dalam file log kesalahan. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung sampai Windows Server 2008 R2 dan Windows 7. E_UNEXPECTED digunakan sebagai gantinya.
VSS_E_UNEXPECTED_PROVIDER_ERROR	Kesalahan penyedia tak terduga. Kode kesalahan dicatat dalam log kesalahan. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.

Keterangan

Pemanggil harus mengatur konten struktur VSS_SNAPSHOT_PROP ke nol sebelum memanggil metode GetSnapshotProperties .

Penyedia bertanggung jawab untuk mengalokasikan dan membebaskan string dalam struktur VSS_SNAPSHOT_PROP .

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	vsbackup.h (termasuk VsBackup.h, Vss.h, VsWriter.h)
Pustaka	VssApi.lib