Metode IVssComponentEx2::GetFailure (vswriter.h)

Artikel
03/03/2024

Pemohon VSS memanggil metode ini untuk mengambil kesalahan tingkat komponen yang dilaporkan oleh penulis.

Sintaks

HRESULT GetFailure(
  [out] HRESULT *phr,
  [out] HRESULT *phrApplication,
  [out] BSTR    *pbstrApplicationMessage,
  [out] DWORD   *pdwReserved
);

Parameter

[out] phr

Alamat variabel yang dialokasikan pemanggil yang menerima kode kegagalan HRESULT yang diteruskan penulis untuk parameter jam metode IVssComponentEx2::SetFailure . Parameter ini diperlukan dan tidak boleh NULL.

Berikut ini adalah nilai yang didukung.

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_WRITER_NOT_RESPONDING	Penulis tidak merespons.
VSS_E_WRITER_STATUS_NOT_AVAILABLE	Status penulis tidak tersedia untuk satu atau beberapa penulis. Penulis mungkin telah mencapai jumlah maksimum sesi pencadangan dan pemulihan yang tersedia.

[out] phrApplication

Alamat variabel yang dialokasikan penelepon yang menerima kode pengembalian yang diteruskan penulis untuk parameter hrApplication dari metode SetFailure . Parameter ini diperlukan dan tidak boleh NULL.

[out] pbstrApplicationMessage

Alamat variabel yang dialokasikan penelepon yang menerima pesan kegagalan aplikasi yang diteruskan penulis untuk parameter wszApplicationMessage dari metode SetFailure . Parameter ini diperlukan dan tidak boleh NULL.

[out] pdwReserved

Alamat variabel DWORD yang dialokasikan penelepon. Parameter ini dicadangkan untuk digunakan di masa mendatang, tetapi diperlukan dan tidak boleh NULL.

Nilai kembali

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai	Makna
S_OK 0x00000000L	Berhasil mengembalikan status penulis yang ditentukan. Perhatikan bahwa nilai parameter phrFailureWriter harus diperiksa untuk memverifikasi bahwa penulis berhasil. Kode kegagalan penulis dapat berada di antara yang tercantum di VsWriter.h dan di Writer Errors and Vetoes.
E_INVALIDARG 0x80070057L	Parameter phr, phrApplication, pbstrApplicationMessage, atau pdwReserved adalah NULL.
E_OUTOFMEMORY 0x8007000EL	Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_BAD_STATE 0x80042301L	Objek komponen cadangan tidak diinisialisasi, metode ini telah dipanggil selama operasi pemulihan, atau metode ini belum dipanggil dalam urutan yang benar.

Keterangan

Ketika pemanggil telah selesai mengakses informasi status yang dikembalikan oleh metode ini, pemanggil harus memanggil SysFreeString untuk membebaskan memori yang dipegang oleh parameter pbstrApplicationMessage .

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

Lihat juga

IVssComponentEx2

Bagikan melalui