Metode IVssBackupComponents::GatherWriterMetadata (vsbackup.h)
Metode GatherWriterMetadata meminta setiap penulis untuk mengirim metadata yang telah mereka kumpulkan. Metode ini akan menghasilkan peristiwa Identifikasi untuk berkomunikasi dengan penulis.
Sintaks
HRESULT GatherWriterMetadata(
[out] IVssAsync **pAsync
);
Parameter
[out] pAsync
Penunjuk tidak langsung dua kali ke objek IVssAsync yang berisi metadata penulis.
Mengembalikan nilai
Berikut ini adalah kode pengembalian yang valid untuk metode ini.
| Nilai | Makna |
|---|---|
|
Berhasil mengembalikan pointer ke instans antarmuka IVssAsync . Lihat IVssAsync::QueryStatus untuk nilai valid yang dikembalikan oleh parameter pHrResult . |
|
Pemanggil tidak memiliki hak pencadangan yang memadai atau bukan administrator. |
|
ppAsync tidak menunjuk ke penunjuk yang valid; artinya, itu 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. |
|
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. |
|
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. |
Keterangan
Pemanggil bertanggung jawab untuk merilis antarmuka IVssAsync .
GatherWriterMetadata harus dipanggil hanya sekali selama masa pakai objek IVssBackupComponents tertentu.
GatherWriterMetadata menghasilkan peristiwa Identifikasi, yang ditangani oleh setiap instans setiap penulis melalui metode CVssWriter::OnIdentify , yang digunakan untuk mengisi Dokumen Metadata Penulis.
Persyaratan
| 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 |