Bagikan melalui


Metode IVssBackupComponents::GatherWriterStatus (vsbackup.h)

Metode GatherWriterStatus meminta setiap penulis untuk mengirim pesan status.

Sintaks

HRESULT GatherWriterStatus(
  [out] IVssAsync **pAsync
);

Parameter

[out] pAsync

Dua kali penunjuk tidak langsung ke objek IVssAsync yang berisi data status penulis.

Nilai kembali

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai Makna
S_OK
Berhasil mengembalikan pointer ke instans antarmuka IVssAsync . Lihat IVssAsync::QueryStatus untuk nilai valid yang dikembalikan oleh parameter pHrResult .
E_ACCESSDENIED
Pemanggil tidak memiliki hak istimewa pencadangan yang memadai atau bukan administrator.
E_INVALIDARG
ppAsync tidak menunjuk ke penunjuk yang valid; yaitu, null.
E_OUTOFMEMORY
Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_BAD_STATE
Objek komponen cadangan tidak diinisialisasi, metode ini telah dipanggil selama operasi pemulihan, atau metode ini belum dipanggil dalam urutan yang benar.
VSS_E_UNEXPECTED
Kesalahan tak terduga. Kode kesalahan dicatat dalam file log kesalahan. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung sampai Windows Server 2008 R2 dan Windows 7. E_UNEXPECTED digunakan sebagai gantinya.

VSS_E_WRITER_INFRASTRUCTURE
Infrastruktur penulis tidak beroperasi dengan benar. Periksa apakah Layanan Peristiwa dan VSS telah dimulai, dan periksa kesalahan yang terkait dengan layanan tersebut di log kesalahan.

Keterangan

Pemanggil metode ini juga harus memanggil IVssBackupComponents::FreeWriterStatus setelah menerima status setiap penulis.

Setelah memanggil BackupComplete, pemohon harus memanggil GatherWriterStatus untuk menyebabkan sesi penulis diatur ke status selesai.

Catatan Ini hanya diperlukan pada Windows Server 2008 dengan Paket Layanan 2 (SP2) dan yang lebih lama.
 
Kelas CVssWriter menangani pesan status yang dikirim oleh setiap penulis.

Pemanggil bertanggung jawab untuk merilis antarmuka IVssAsync .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header vsbackup.h (termasuk VsBackup.h, Vss.h, VsWriter.h)
Pustaka VssApi.lib

Lihat juga

CVssWriter

IVssAsync

IVssAsync::QueryStatus

IVssBackupComponents

IVssBackupComponents::FreeWriterStatus