Metode CVssWriterEx2::SetWriterFailureEx (vswriter.h)

Artikel
03/03/2024

Mengatur informasi kesalahan yang diperluas untuk menunjukkan bahwa penulis mengalami masalah dengan berpartisipasi dalam operasi VSS.

Sintaks

HRESULT SetWriterFailureEx(
  [in] HRESULT hrWriter,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage
);

Parameter

[in] hrWriter

Kode kesalahan yang akan dikembalikan ke pemohon.

Berikut ini adalah kode kesalahan yang dapat diatur metode ini.

Nilai	Makna
S_OK	Penulis berhasil.
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT	Salinan bayangan hanya berisi subset volume yang diperlukan oleh penulis untuk mencadangkan komponen aplikasi dengan benar.
VSS_E_WRITERERROR_OUTOFRESOURCES	Penulis kehabisan memori atau sumber daya sistem lainnya. Cara yang disarankan untuk menangani kode kesalahan ini adalah dengan menunggu sepuluh menit dan kemudian mengulangi operasi, hingga tiga kali.
VSS_E_WRITERERROR_TIMEOUT	Operasi penulis gagal karena waktu habis antara peristiwa Freeze dan Thaw. Cara yang disarankan untuk menangani kode kesalahan ini adalah dengan menunggu sepuluh menit dan kemudian mengulangi operasi, hingga tiga kali.
VSS_E_WRITERERROR_RETRYABLE	Penulis gagal karena kesalahan yang kemungkinan tidak akan terjadi jika seluruh proses pembuatan cadangan, pemulihan, atau salinan bayangan dimulai ulang. Cara yang disarankan untuk menangani kode kesalahan ini adalah dengan menunggu sepuluh menit dan kemudian mengulangi operasi, hingga tiga kali.
VSS_E_WRITERERROR_NONRETRYABLE	Operasi penulis gagal karena kesalahan yang mungkin berulang jika salinan bayangan lain dibuat. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.
VSS_E_WRITERERROR_PARTIAL_FAILURE	Penulis melaporkan satu atau beberapa kesalahan tingkat komponen. Untuk melaporkan kesalahan, penulis harus menggunakan metode IVssComponentEx2::SetFailure .

[in] hrApplication

Kode kesalahan tambahan yang akan dikembalikan ke pemohon. Parameter ini bersifat opsional.

[in] wszApplicationMessage

String yang berisi pesan kesalahan untuk ditampilkan pemohon kepada pengguna akhir. Penulis bertanggung jawab untuk melokalisasi string ini jika perlu sebelum menggunakannya dalam metode ini. Parameter ini bersifat opsional dan dapat berupa NULL atau string kosong.

Nilai kembali

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

Keterangan

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

Untuk melaporkan kesalahan tingkat komponen, penulis harus menggunakan metode IVssComponentEx2::SetFailure .

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

Persyaratan

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

Lihat juga

CVssWriter::SetWriterFailure

CVssWriterEx2

IVssBackupComponentsEx3::GetWriterStatusEx

Bagikan melalui