Metode IVssComponent::SetBackupStamp (vswriter.h)

  • Artikel

Metode SetBackupStamp menetapkan string yang berisi informasi yang menunjukkan kapan pencadangan terjadi.

Penulis hanya dapat memanggil metode ini selama operasi pencadangan.

Metode ini tidak dapat dipanggil saat menangani peristiwa BackupComplete (CVssWriter::OnBackupComplete) atau BackupShutdown (CVssWriter::OnBackupShutdown).

Sintaks

HRESULT SetBackupStamp(
  [in] LPCWSTR wszBackupStamp
);

Parameter

[in] wszBackupStamp

Informasi string karakter lebar yang dihentikan null yang menunjukkan kapan pencadangan terjadi.

Nilai kembali

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai Makna
S_OK
 Berhasil mengatur stempel waktu pencadangan.
E_INVALIDARG
 Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY
 Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_BAD_STATE
 Metode ini tidak dipanggil oleh penulis atau, jika dipanggil oleh penulis, metode ini tidak dipanggil selama operasi pencadangan atau dipanggil saat menangani peristiwa BackupComplete atau BackupShutdown.

Keterangan

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

Stempel cadangan yang diatur oleh SetBackupStamp berlaku untuk semua file dalam komponen dan subkomponen yang tidak dapat dipilih yang dimilikinya.

Penulis biasanya memanggil SetBackupStamp saat menangani peristiwa PostSnapshot di CVssWriter::OnPostSnapshot.

Pemohon hanya menyimpan stempel cadangan di Dokumen Komponen Cadangan. Mereka tidak menggunakan stempel cadangan secara langsung atau harus tahu cara menafsirkannya.

Satu-satunya penggunaan stempel cadangan yang dibuat pemohon, selama operasi pemulihan, adalah membuat string stempel waktu yang disimpan tersedia untuk penulis dengan menggunakan metode IVssBackupComponents::SetPreviousBackupStamp .

Untuk alasan ini, tidak ada batasan format pada konten stempel cadangan. Ini mungkin berisi informasi waktu dan tanggal, nomor urutan logis, atau informasi lain yang akan memungkinkan penulis kelas yang sama untuk menentukan kapan pencadangan terakhir telah terjadi.

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

IVssComponent

IVssComponent::GetBackupStamp