Metode IVssBackupComponents::GatherWriterMetadata (vsbackup.h)

  • Artikel

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
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 pencadangan yang memadai atau bukan administrator.
E_INVALIDARG
 ppAsync tidak menunjuk ke penunjuk yang valid; artinya, itu ADALAH 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_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.
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.

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

Lihat juga

CVssWriter::OnIdentify

IVssAsync

IVssAsync::QueryStatus

IVssBackupComponents