Metode IVssFileShareSnapshotProvider::GetSnapshotProperties (vsprov.h)

  • Artikel

Mendapatkan struktur VSS_SNAPSHOT_PROP untuk rekam jepret berbagi file.

Sintaks

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

Parameter

[in] SnapshotId

Pengidentifikasi salinan bayangan.

[out] pProp

Alamat struktur VSS_SNAPSHOT_PROP yang dialokasikan pemanggil yang menerima properti salinan bayangan. Penyedia bertanggung jawab untuk menetapkan anggota struktur ini. Semua anggota diperlukan kecuali m_pwszExposedName dan m_pwszExposedPath, yang dapat diatur penyedia ke NULL. Penyedia mengalokasikan memori untuk semua anggota string yang ditetapkannya dalam struktur. Ketika struktur tidak lagi diperlukan, pemanggil 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
 Informasi yang diminta berhasil dikembalikan.
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_OBJECT_NOT_FOUND
 Volume yang ditentukan tidak ditemukan.
VSS_E_PROVIDER_VETO
 Kesalahan penyedia. 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.

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 .

Koordinator VSS memanggil metode ini selama fase PostSnapshot pembuatan rekam jepret untuk mengambil jalur akses rekam jepret (jalur UNC untuk rekam jepret berbagi file). Koordinator memanggil metode ini setelah PreFinalCommitSnapshots dan sebelum memanggil PostSnapshot di penulis.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8.1 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2012 R2 [hanya aplikasi desktop]
Target Platform Windows
Header vsprov.h
Pustaka VssApi.lib

Lihat juga

IVssFileShareSnapshotProvider