Metode IVssComponent::GetBackupStamp (vswriter.h)

  • Artikel

Metode GetBackupStamp mengembalikan string stempel cadangan yang disimpan oleh penulis untuk komponen tertentu.

Penulis atau pemohon dapat memanggil metode ini.

Sintaks

HRESULT GetBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

Parameter

[out] pbstrBackupStamp

Alamat variabel yang dialokasikan penelepon yang menerima string yang berisi stempel cadangan yang menunjukkan waktu di mana komponen dicadangkan.

Mengembalikan nilai

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai Makna
S_OK
 Berhasil mengembalikan nilai atribut.
S_FALSE
 Tidak ada stempel waktu yang terkait dengan komponen ini.
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

Jika tidak ada stempel waktu pencadangan yang ditetapkan, GetBackupStamp akan mengembalikan S_FALSE.

Jika panggilan ke GetBackupStamp berhasil, pemanggil bertanggung jawab untuk membebaskan string yang dikembalikan dalam parameter pbstrBackupStamp dengan memanggil fungsi SysFreeString .

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

Stempel cadangan yang diambil oleh GetBackupStamp umumnya diatur oleh penulis dengan panggilan ke IVssComponent::SetBackupStamp dari dalam penanganan aktivitas PostSnapshot , CVssWriter::OnPostSnapshot.

Pemohon hanya menyimpan stempel cadangan di Dokumen Komponen Cadangan; mereka tidak menggunakan stempel cadangan secara langsung, tahu cara membuatnya, atau memahami formatnya.

Persyaratan

   
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

IVssComponent::SetBackupStamp