Metode IVssBackupComponents::GetWriterComponents (vsbackup.h)
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 |
---|---|
|
Berhasil mengembalikan penunjuk ke objek antarmuka IVssWriterComponentsExt . |
|
Salah satu nilai parameter tidak valid. |
|
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. |
|
Salinan bayangan yang ditentukan tidak ada. |
|
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 repareForBackupIVssBackupComponents::D oSnapshotSetIVssBackupComponents::BackupCompleteIVssBackupComponents::P reRestoreIVssBackupComponents::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 |
Lihat juga
IVssBackupComponents::AddComponent
IVssBackupComponents::GatherWriterMetadata
IVssBackupComponents::GetWriterComponentsCount
IVssBackupComponents::GetWriterMetadata
IVssBackupComponents::P reRestore
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk