Metode IVssComponentEx2::SetFailure (vswriter.h)
Penulis VSS memanggil metode ini untuk melaporkan kesalahan di tingkat komponen.
Sintaks
HRESULT SetFailure(
[in] HRESULT hr,
[in] HRESULT hrApplication,
[in] LPCWSTR wszApplicationMessage,
[in] DWORD dwReserved
);
Parameter
[in] hr
Kode kesalahan yang akan dikembalikan ke pemohon yang memanggil metode IVssComponentEx2::GetFailure .
Berikut ini adalah kode kesalahan yang dapat diatur metode ini.
Nilai | Makna |
---|---|
|
Penulis berhasil. |
|
Salinan bayangan hanya berisi subset volume yang diperlukan oleh penulis untuk mencadangkan komponen aplikasi dengan benar. |
|
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. |
|
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. |
|
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. |
|
Operasi penulis gagal karena kesalahan yang mungkin berulang jika salinan bayangan lain dibuat. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS. |
[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.
[in] dwReserved
Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus diatur ke nol.
Mengembalikan nilai
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Selain memanggil metode ini, gunakan metode CVssWriterEx2::SetWriterFailureEx untuk melaporkan bahwa kegagalan penulis parsial telah terjadi.
Metode ini tidak dapat dipanggil dari CVssWriter::OnIdentify atau CVssWriterEx::OnIdentifyEx.
Persyaratan
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 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk