Metode IVssBackupComponentsEx3::GetWriterStatusEx (vsbackup.h)
Mengembalikan informasi status yang diperluas untuk penulis yang ditentukan.
Sintaks
HRESULT GetWriterStatusEx(
[in] UINT iWriter,
[out] VSS_ID *pidInstance,
[out] VSS_ID *pidWriter,
[out] BSTR *pbstrWriter,
[out] VSS_WRITER_STATE *pnStatus,
[out] HRESULT *phrFailureWriter,
[out, optional] HRESULT *phrApplication,
[out, optional] BSTR *pbstrApplicationMessage
);
Parameter
[in] iWriter
Indeks penulis yang metadatanya akan diambil. Nilai parameter ini adalah bilangan bulat dari 0 hingga n–1 inklusif, di mana n adalah jumlah total penulis pada sistem saat ini. Nilai n dikembalikan oleh metode IVssBackupComponents::GetWriterStatusCount .
[out] pidInstance
Alamat variabel yang dialokasikan pemanggil yang menerima pengidentifikasi instans penulis. Parameter ini diperlukan dan tidak boleh NULL.
[out] pidWriter
Alamat variabel yang dialokasikan pemanggil yang menerima pengidentifikasi untuk kelas penulis. Parameter ini diperlukan dan tidak boleh NULL.
[out] pbstrWriter
Alamat variabel yang dialokasikan pemanggil yang menerima string yang berisi nama penulis yang ditentukan. Parameter ini diperlukan dan tidak boleh NULL.
[out] pnStatus
Alamat variabel yang dialokasikan pemanggil yang menerima nilai enumerasi VSS_WRITER_STATE . Parameter ini diperlukan dan tidak boleh NULL.
[out] phrFailureWriter
Alamat variabel yang dialokasikan pemanggil yang menerima kode kegagalan HRESULT yang dikembalikan penulis untuk parameter hrWriter metode CVssWriterEx2::SetWriterFailureEx .
Berikut ini adalah nilai yang didukung.
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. |
|
Penulis tidak merespons. |
|
Status penulis tidak tersedia untuk satu atau beberapa penulis. Penulis mungkin telah mencapai jumlah maksimum sesi pencadangan dan pemulihan yang tersedia. |
|
Penulis melaporkan satu atau beberapa kesalahan tingkat komponen. Untuk mengambil kesalahan, pemohon harus menggunakan metode IVssComponentEx2::GetFailure . |
[out, optional] phrApplication
Alamat variabel yang dialokasikan pemanggil yang menerima kode pengembalian yang diteruskan penulis untuk parameter hrApplication dari metode CVssWriterEx2::SetWriterFailureEx . Parameter ini bersifat opsional dan dapat berupa NULL.
[out, optional] pbstrApplicationMessage
Alamat variabel yang menerima pesan kegagalan aplikasi yang diteruskan penulis untuk parameter wszApplicationMessage dari metode SetWriterFailureEx . Parameter ini bersifat opsional dan dapat berupa NULL.
Nilai kembali
Berikut ini adalah kode pengembalian yang valid untuk metode ini.
Nilai | Makna |
---|---|
|
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. |
|
Parameter pnStatus, pidWriter, pbstrWriter, atau pidInstance adalah NULL. |
|
Pemanggil kehabisan memori atau sumber daya sistem lainnya. |
|
Objek komponen cadangan tidak diinisialisasi, metode ini telah dipanggil selama operasi pemulihan, atau metode ini belum dipanggil dalam urutan yang benar. |
|
Parameter iWriter menentukan penulis yang tidak ada. |
Keterangan
Pemohon harus memanggil operasi asinkron IVssBackupComponents::GatherWriterStatus dan menunggunya selesai sebelum memanggil IVssBackupComponentsEx3::GetWriterStatusEx.
Jika metode ini mengembalikan VSS_E_WRITERERROR_PARTIAL_FAILURE, pemohon harus menggunakan metode IVssComponentEx2::GetFailure untuk mengambil kesalahan tingkat komponen.
Ketika pemanggil telah selesai mengakses informasi status yang dikembalikan oleh metode ini, pemanggil harus memanggil SysFreeString untuk membebaskan memori yang dipegang oleh parameter pbstrWriter dan 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 | vsbackup.h (termasuk VsBackup.h, Vss.h, VsWriter.h) |
Lihat juga
CVssWriterEx2::SetWriterFailureEx
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