Metode IVssBackupComponents::GetWriterComponents (vsbackup.h)

Artikel
08/27/2023

Metode GetWriterComponents digunakan untuk mengembalikan informasi tentang komponen penulis tertentu yang telah disimpan dalam Dokumen Komponen Cadangan pemohon.

Sintaks

HRESULT GetWriterComponents(
  [in]  UINT                    iWriter,
  [out] IVssWriterComponentsExt **ppWriter
);

Parameter

[in] iWriter

Indeks penulis yang sedang dikueri. Ini adalah angka antara 0 dan n-1, di mana n adalah nilai yang dikembalikan oleh IVssBackupComponents::GetWriterComponentsCount.

[out] ppWriter

Dua arah tidak langsung ke objek antarmuka IVssWriterComponentsExt yang akan menerima informasi komponen yang dikembalikan.

Nilai kembali

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai	Makna
S_OK	Berhasil mengembalikan penunjuk ke objek antarmuka IVssWriterComponentsExt .
E_INVALIDARG	Salah satu nilai parameter tidak valid.
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_OBJECT_NOT_FOUND	Salinan bayangan yang ditentukan tidak ada.
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 metode ini harus memanggil IUnknown::Release setelah selesai mengakses informasi komponen.

GetWriterComponents mengambil informasi komponen untuk komponen yang disimpan dalam Dokumen Komponen Cadangan dengan panggilan sebelumnya ke IVssBackupComponents::AddComponent.

Informasi dalam komponen yang disimpan dalam Dokumen Komponen Cadangan tidak statis. Jika penulis memperbarui komponen selama pemulihan, perubahan tersebut akan tercermin dalam komponen yang diambil oleh GetWriterComponents. Ini berbeda dengan informasi komponen yang ditemukan di objek IVssWMComponent yang dikembalikan oleh IVssExamineWriterMetadata::GetComponent. Informasi tersebut bersifat baca-saja dan berasal dari Dokumen Metadata Penulis dari proses penulis.

Penunjuk antarmuka IVssWriterComponentsExt yang dikembalikan dalam parameter pWriterComponents tidak boleh di-cache, karena metode IVssBackupComponents berikut menyebabkan penunjuk antarmuka yang dikembalikan oleh GetWriterComponents tidak lagi valid:

IVssBackupComponents::P repareForBackup IVssBackupComponents::D oSnapshotSet IVssBackupComponents::BackupComplete IVssBackupComponents::P reRestore IVssBackupComponents::P ostRestore Jika Anda memanggil salah satu metode ini setelah Anda mengambil penunjuk antarmuka IVssWriterComponentsExt dengan memanggil GetWriterComponents, Anda tidak dapat menggunakan kembali penunjuk tersebut, karena tidak lagi valid. Sebagai gantinya, Anda harus memanggil GetWriterComponents lagi untuk mengambil penunjuk antarmuka IVssWriterComponentsExt baru.

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