Metode IVssBackupComponentsEx3::GetWriterStatusEx (vsbackup.h)

  • Artikel

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
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.
VSS_E_WRITERERROR_PARTIAL_FAILURE
 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
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 pnStatus, pidWriter, pbstrWriter, atau pidInstance 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.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
 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

IVssBackupComponents::GetWriterStatus

IVssBackupComponentsEx3