Metode IVssComponent::GetPreviousBackupStamp (vswriter.h)

  • Artikel

Metode GetPreviousBackupStamp mengembalikan stempel cadangan sebelumnya yang dimuat oleh pemohon di Dokumen Komponen Cadangan. Nilai digunakan oleh penulis saat memutuskan apakah file harus berpartisipasi dalam operasi pencadangan diferensial atau bertambah bertahap.

Penulis atau pemohon dapat memanggil metode ini.

Sintaks

HRESULT GetPreviousBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

Parameter

[out] pbstrBackupStamp

Penunjuk ke string yang berisi stempel waktu cadangan sebelumnya sehingga cadangan diferensial atau bertahap dapat diimplementasikan dengan benar.

Nilai kembali

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai Makna
S_OK
 Berhasil mengembalikan nilai atribut.
S_FALSE
 Tidak ada stempel waktu pencadangan sebelumnya yang telah ditetapkan.
E_INVALIDARG
 Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY
 Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_INVALID_XML_DOCUMENT
 Dokumen XML tidak valid. Periksa log peristiwa untuk detailnya. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.

Keterangan

Untuk informasi selengkapnya tentang stempel cadangan, lihat Peran Penulis dalam Mencadangkan Penyimpanan Kompleks dan Peran Pemohon di Mencadangkan Penyimpanan Kompleks.

Pemanggil harus membebaskan memori yang dipegang oleh parameter pbstrBackupStamp dengan memanggil SysFreeString.

Jika tidak ada stempel waktu pencadangan sebelumnya, GetPreviousBackupStamp mengembalikan S_FALSE.

String yang dikembalikan mengacu pada semua file dalam komponen dan subkomponen yang tidak dapat dipilih yang dimilikinya.

Stempel cadangan yang diambil oleh GetPreviousBackupStamp diatur oleh pemohon menggunakan IVssBackupComponents::SetPreviousBackupStamp.

Biasanya, string yang digunakan untuk mengatur nilai yang ditemukan oleh GetPreviousBackupStamp diambil dari Dokumen Komponen Cadangan yang disimpan atau disimpan oleh pemohon sebagai bagian dari rekaman internalnya sendiri.

Persyaratan

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

Lihat juga

IVssBackupComponents::SetPreviousBackupStamp

IVssComponent