Metode IVssComponent::GetPreRestoreFailureMsg (vswriter.h)

Metode GetPreRestoreFailureMsg mengambil pesan kesalahan yang dihasilkan oleh penulis saat menangani peristiwa PreRestore , jika IVssComponent::SetPreRestoreFailureMsg menetapkan satu.

Penulis atau pemohon dapat memanggil metode ini.

Sintaks

HRESULT GetPreRestoreFailureMsg(
  [out] BSTR *pbstrPreRestoreFailureMsg
);

[out] pbstrPreRestoreFailureMsg

String yang berisi pesan kegagalan yang menjelaskan kesalahan yang terjadi saat memproses peristiwa PreRestore .

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai	Makna
S_OK	Berhasil mengembalikan nilai atribut.
S_FALSE	Tidak ada pesan kegagalan PreRestore yang tersedia untuk diambil.
E_INVALIDARG	Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY	Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_INVALID_XML_DOCUMENT	Dokumen XML tidak valid. Periksa log peristiwa untuk detailnya. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.

Pemanggil harus membebaskan memori yang dipegang oleh parameter pbstrPreRestoreFailureMsg dengan memanggil SysFreeString.

Jika SetPreRestoreFailureMsg tidak digunakan untuk mengatur pesan kegagalan PreRestore , GetPreRestoreFailureMsg mengembalikan S_FALSE.


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