CVssWriter::SetWriterFailure method (vswriter.h)

  • Artikel

Metode SetWriterFailure menunjukkan bahwa penulis ini mengalami kondisi kesalahan dan menetapkan kondisi kesalahan.

SetWriterFailure adalah metode terlindungi yang diterapkan oleh kelas dasar CVssWriter .

Sintaks

HRESULT SetWriterFailure(
  [in] HRESULT hr
);

Parameter

[in] hr

Kode kesalahan yang akan diatur. Berikut ini adalah kode kesalahan yang dapat diatur metode ini.

Nilai Makna
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT
 Salinan bayangan hanya berisi subset volume yang diperlukan untuk mencadangkan komponen aplikasi dengan benar.
VSS_E_WRITERERROR_NONRETRYABLE
 Penulis gagal karena kesalahan yang kemungkinan akan terjadi jika salinan bayangan lain dibuat.
VSS_E_WRITERERROR_OUTOFRESOURCES
 Penulis gagal karena kesalahan alokasi sumber daya.
VSS_E_WRITERERROR_RETRYABLE
 Penulis gagal karena kesalahan yang kemungkinan tidak akan terjadi jika seluruh proses pembuatan cadangan, pemulihan, atau salinan bayangan dimulai ulang.
VSS_E_WRITERERROR_TIMEOUT
 Penulis tidak dapat menyelesaikan pembuatan salinan bayangan karena waktu antara status pembekuan dan pencairan melebihi nilai waktu habis (dwTimeoutFreeze) yang diatur dalam CVssWriter::Initialize.

Mengembalikan nilai

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini tidak dapat dipanggil dari CVssWriter::OnIdentify atau CVssWriterEx::OnIdentifyEx.

Jika penanganan aktivitas penulis (seperti CVssWriter::OnFreeze) memanggil metode ini, itu harus melakukannya di utas yang sama yang disebut penanganan aktivitas. Untuk informasi selengkapnya, lihat Penanganan Peristiwa Penulis.

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

CVssWriter

IVssBackupComponents::GetWriterStatus