Metode IVssBackupComponents::AddComponent (vsbackup.h)
Metode AddComponent digunakan untuk secara eksplisit menambahkan ke kumpulan cadangan dalam Dokumen Komponen Cadangan semua komponen yang diperlukan (tidak dapat dipilih untuk komponen cadangan tanpa dipilih untuk leluhur cadangan), dan komponen opsional (dapat dipilih untuk cadangan) karena pemohon menganggap perlu. Anggota set komponen (komponen dengan yang dapat dipilih untuk leluhur cadangan) secara implisit disertakan dalam kumpulan cadangan, tetapi tidak secara eksplisit ditambahkan ke Dokumen Komponen Cadangan.
Sintaks
HRESULT AddComponent(
[in] VSS_ID instanceId,
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName
);
Parameter
[in] instanceId
Mengidentifikasi instans penulis tertentu.
[in] writerId
Pengidentifikasi kelas penulis.
[in] ct
Mengidentifikasi jenis komponen. Lihat dokumentasi untuk VSS_COMPONENT_TYPE untuk nilai input yang diizinkan.
[in] wszLogicalPath
String karakter lebar yang dihentikan null yang berisi jalur logis yang dapat dipilih untuk komponen cadangan. Untuk informasi selengkapnya, lihat Jalur Logis Komponen.
Jalur logis tidak diperlukan saat menambahkan komponen. Oleh karena itu, nilai parameter ini bisa null.
Tidak ada batasan pada karakter yang dapat muncul di jalur logika non-NULL .
[in] wszComponentName
String karakter lebar yang dihentikan null yang berisi nama yang dapat dipilih untuk komponen cadangan.
Nilai parameter ini tidak boleh NULL.
Tidak ada batasan pada karakter yang dapat muncul di jalur logika non-NULL .
Mengembalikan nilai
Berikut ini adalah kode pengembalian yang valid untuk metode ini.
| Nilai | Makna |
|---|---|
|
Berhasil menambahkan komponen. |
|
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. |
|
Dokumen XML tidak valid. Periksa log peristiwa untuk detailnya. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS. |
|
Objek adalah duplikat. Komponen dengan jalur logis dan nama komponen yang sama sudah 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
Metode AddComponent memiliki arti hanya jika operasi pencadangan terjadi dalam mode komponen.
Hanya komponen semacam ini yang harus ditambahkan ke Dokumen Komponen Cadangan menggunakan AddComponent.
- Komponen yang dapat dipilih untuk pencadangan (lihat keterpilih untuk pencadangan).
- Komponen nonselectable-for-backup tanpa leluhur yang dapat dipilih untuk cadangan.
Tidak dapat dipilih untuk komponen cadangan yang memiliki pilihan untuk leluhur cadangan dalam hierarki jalur logis mereka adalah bagian dari set komponen yang ditentukan oleh yang dapat dipilih untuk leluhur cadangan. Komponen-komponen ini secara implisit ditambahkan ke Dokumen Komponen Cadangan ketika leluhur ditambahkan dan tidak boleh ditambahkan secara eksplisit ke Dokumen Komponen Cadangan pemohon dengan menggunakan AddComponent. Hasil dari melakukannya tidak terdefinisi (lihat Bekerja dengan Pemilihan dan Jalur Logis).
Dapat dipilih untuk komponen cadangan dengan yang dapat dipilih untuk leluhur cadangan juga merupakan subkomponen dalam set komponen. Mereka dapat dipilih secara implisit jika leluhur mereka dipilih (dalam hal ini mereka tidak ditambahkan ke Dokumen Komponen Cadangan menggunakan AddComponent), atau mereka dapat dipilih secara eksplisit menggunakan AddComponent.
Kombinasi jalur logis dan nama untuk setiap komponen instans tertentu dari kelas penulis tertentu harus unik. Mencoba memanggil AddComponent dua kali dengan nilai wszLogicalPath dan wszComponentName yang sama menghasilkan kesalahan VSS_E_OBJECT_ALREADY_EXISTS.
Perbedaan antara instanceId dan writerID diperlukan karena dimungkinkan untuk menjalankan beberapa salinan untuk penulis yang sama.
Pengidentifikasi dan instans kelas penulis dapat ditemukan dengan memanggil IVssExamineWriterMetadata::GetIdentity.
Sebelum memanggil AddComponent, pemohon harus diinisialisasi untuk pencadangan dengan memanggil IVssBackupComponents::InitializeForBackup dan IVssBackupComponents::GatherWriterMetadata. Lihat Gambaran Umum Inisialisasi Cadangan.
Pemohon harus memanggil AddComponent untuk menambahkan komponen yang diperlukan ke salinan bayangan sebelum memanggil IVssBackupComponents::D oSnapshotSet untuk membuat salinan bayangan. Lihat Gambaran Umum Fase Penemuan Cadangan dan Gambaran Umum Tugas Pra-Pencadangan.
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::P repareForBackup
Saran dan Komentar
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: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk