Metode IVssBackupComponents::GatherWriterStatus (vsbackup.h)

Metode GatherWriterStatus meminta setiap penulis untuk mengirim pesan status.

Sintaks

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

[out] pAsync

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

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.

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	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