Kelas IVssComponent (vswriter.h)

Antarmuka IVssComponent adalah antarmuka C++ (bukan COM) yang berisi metode untuk memeriksa dan memodifikasi informasi tentang komponen yang terkandung dalam Dokumen Komponen Cadangan pemohon.

Objek IVssComponent hanya dapat diperoleh untuk komponen yang telah ditambahkan secara eksplisit ke Dokumen Komponen Cadangan selama operasi pencadangan oleh metode IVssBackupComponents::AddComponent .

Informasi tentang komponen yang secara eksplisit ditambahkan selama operasi pemulihan menggunakan IVssBackupComponents::AddRestoreSubcomponent tidak tersedia melalui antarmuka IVssComponent .

Beberapa informasi yang umum untuk komponen dan subkomponen yang dipilih secara implisit yang tersedia melalui objek IVssComponent mencakup hal berikut:

  • Stempel waktu pencadangan
  • Pesan Kegagalan Pra-/pasca-pemulihan
  • Memulihkan metadata
  • Pulihkan target
Beberapa informasi dalam objek IVssComponent berdasarkan per file dan dapat merujuk ke file yang dikelola baik dengan komponen yang dipilih secara eksplisit atau dengan subkomponen yang dipilih secara implisit:
  • Pemetaan lokasi alternatif
  • File parsial
  • Target yang diarahkan
Informasi lain tidak disertakan dalam Dokumen Komponen Cadangan dan dapat disimpulkan menggunakan objek IVssComponent bersama dengan Dokumen Metadata Penulis yang sesuai berdasarkan hierarki komponen penulis yang dinyatakan di jalur logis (lihat Bekerja dengan Jalur Pemilihan dan Logis).

Antarmuka dapat digunakan oleh penulis atau pemohon, meskipun metode tertentu hanya didukung untuk penulis. Dengan cara ini, penulis dapat meminta perubahan dalam operasi pencadangan atau pemulihan, seperti menambahkan target baru, atau mempelajari tindakan pemohon, seperti penggunaan lokasi alternatif.

Metode berikut mengembalikan antarmuka IVssComponent :

Warisan

Antarmuka IVssComponent mewarisi dari antarmuka IUnknown . IVssComponent juga memiliki jenis anggota ini:

Metode

Kelas IVssComponent memiliki metode ini.

 
IVssComponent::AddDifferencedFilesByLastModifyLSN

Tidak didukung. (IVssComponent.AddDifferencedFilesByLastModifyLSN)
IVssComponent::AddDifferencedFilesByLastModifyTime

Digunakan oleh penulis untuk menunjukkan bahwa kumpulan file (file atau file tertentu) harus dievaluasi terhadap stempel waktu modifikasi terakhir untuk dimasukkan dalam pencadangan bertahap atau diferensial yang diberi stempel waktu menggunakan seluruh file.
IVssComponent::AddDirectedTarget

Metode AddDirectedTarget memungkinkan penulis untuk menunjukkan pada waktu pemulihan bahwa ketika file akan dipulihkan, itu (file sumber) harus dipetakan ulang.
IVssComponent::AddPartialFile

Metode AddPartialFile menunjukkan bahwa hanya bagian dari file tertentu yang akan dicadangkan dan bagian mana yang akan dicadangkan.
IVssComponent::GetAdditionalRestores

Metode GetAdditionalRestores digunakan oleh penulis selama operasi pemulihan bertahap atau diferensial untuk menentukan apakah komponen tertentu akan memerlukan operasi pemulihan tambahan untuk mengambilnya sepenuhnya.
IVssComponent::GetAlternateLocationMapping

GetAlternateLocationMapping digunakan untuk mengembalikan lokasi alternatif kumpulan file untuk pemulihan file. Metode ini dapat dipanggil oleh penulis atau pemohon.
IVssComponent::GetAlternateLocationMappingCount

Metode GetAlternateLocationMappingCount mengembalikan jumlah pemetaan lokasi alternatif yang digunakan oleh pemohon dalam memulihkan data. Penulis atau pemohon dapat memanggil metode ini.
IVssComponent::GetBackupMetadata

Metode GetBackupMetadata mengambil metadata cadangan pribadi khusus penulis yang mungkin telah ditetapkan selama peristiwa PrepareForBackup oleh CVssWriter::OnPrepareBackup menggunakan IVssComponent::SetBackupMetadata.
IVssComponent::GetBackupOptions

Metode GetBackupOptions mengembalikan opsi cadangan yang ditentukan untuk penulis yang mengelola komponen atau komponen yang saat ini dipilih yang ditetapkan oleh pemohon menggunakan IVssBackupComponents::SetBackupOptions.
IVssComponent::GetBackupStamp

Metode GetBackupStamp mengembalikan string stempel cadangan yang disimpan oleh penulis untuk komponen tertentu.
IVssComponent::GetBackupSucceeded

Metode GetBackupSucceeded mengembalikan status upaya lengkap saat mencadangkan semua file komponen atau komponen yang dipilih yang ditetapkan sebagai enumerasi VSS_FILE_RESTORE_STATUS.
IVssComponent::GetComponentName

Metode GetComponentName mengembalikan nama logis komponen ini.
IVssComponent::GetComponentType

Metode GetComponentType mengembalikan jenis komponen ini dalam hal enumerasi VSS_COMPONENT_TYPE.
IVssComponent::GetDifferencedFile

Metode GetDifferencedFile mengembalikan informasi tentang kumpulan file (file atau file tertentu) untuk berpartisipasi dalam pencadangan atau pemulihan bertahap atau diferensial sebagai file yang berbeda yaitu, pencadangan dan pemulihan yang terkait dengannya akan diimplementasikan seolah-olah seluruh file disalin ke dan dari media cadangan (dibandingkan dengan menggunakan file parsial).
IVssComponent::GetDifferencedFilesCount

Mengembalikan jumlah spesifikasi file dalam komponen ini (dan dalam subkomponen dari set komponen yang ditentukannya) yang ditandai oleh penulis yang mendukung pencadangan atau pemulihan inkremental sebagai file yang berbeda.
IVssComponent::GetDirectedTarget

Metode GetDirectedTarget mengembalikan informasi yang disimpan oleh penulis, pada waktu pencadangan, ke Dokumen Komponen Cadangan untuk menunjukkan bahwa ketika file akan dipulihkan, itu (file sumber) harus dipetakan ulang.
IVssComponent::GetDirectedTargetCount

Metode GetDirectedTargetCount mengembalikan jumlah spesifikasi target yang diarahkan yang terkait dengan komponen saat ini. Penulis atau pemohon dapat memanggil metode ini.
IVssComponent::GetFileRestoreStatus

Metode GetFileRestoreStatus mengembalikan status upaya yang telah selesai untuk memulihkan semua file komponen atau komponen yang dipilih yang ditetapkan sebagai enumerasi VSS_FILE_RESTORE_STATUS.
IVssComponent::GetLogicalPath

Metode GetLogicalPath mengembalikan jalur logis komponen ini.
IVssComponent::GetNewTarget

Metode GetNewTarget mengembalikan lokasi pemulihan file baru untuk komponen atau set komponen yang dipilih.
IVssComponent::GetNewTargetCount

Metode GetNewTargetCount mengembalikan jumlah lokasi pemulihan target baru yang terkait dengan komponen tertentu.
IVssComponent::GetPartialFile

Metode GetPartialFile mengembalikan informasi tentang file parsial yang terkait dengan komponen ini.
IVssComponent::GetPartialFileCount

Metode GetPartialFileCount mengembalikan jumlah file parsial yang terkait dengan komponen.
IVssComponent::GetPostRestoreFailureMsg

Metode GetPostRestoreFailureMsg mengembalikan pesan kegagalan yang dihasilkan oleh penulis saat menangani peristiwa PostRestore, jika IVssComponent::SetPostRestoreFailureMsg menetapkan satu.
IVssComponent::GetPreRestoreFailureMsg

Metode GetPreRestoreFailureMsg mengambil pesan kesalahan yang dihasilkan oleh penulis saat menangani peristiwa PreRestore, jika IVssComponent::SetPreRestoreFailureMsg menetapkan satu.
IVssComponent::GetPreviousBackupStamp

Metode GetPreviousBackupStamp mengembalikan stempel cadangan sebelumnya yang dimuat oleh pemohon di Dokumen Komponen Cadangan. Nilai digunakan oleh penulis saat memutuskan apakah file harus berpartisipasi dalam operasi pencadangan diferensial atau bertambah bertahap.
IVssComponent::GetRestoreMetadata

Metode GetRestoreMetadata mengambil metadata pemulihan privat khusus penulis yang mungkin telah diatur selama peristiwa PreRestore oleh CVssWriter::OnPreRestore menggunakan IVssComponent::SetRestoreMetadata.
IVssComponent::GetRestoreOptions

Metode GetRestoreOptions mendapatkan opsi pemulihan yang ditentukan untuk penulis saat ini oleh pemohon menggunakan IVssBackupComponents::SetRestoreOptions.
IVssComponent::GetRestoreSubcomponent

Metode GetRestoreSubcomponent mengembalikan subkomponen yang ditentukan yang terkait dengan komponen tertentu.
IVssComponent::GetRestoreSubcomponentCount

Metode GetRestoreSubcomponentCount mengembalikan jumlah subkomponen yang terkait dengan komponen.
IVssComponent::GetRestoreTarget

Metode GetRestoreTarget mengembalikan target pemulihan (dalam hal enumerasi VSS_RESTORE_TARGET) untuk komponen saat ini.
IVssComponent::IsSelectedForRestore

Metode IsSelectedForRestore menentukan apakah komponen saat ini telah dipilih untuk dipulihkan.
IVssComponent::SetBackupMetadata

Metode SetBackupMetadata mengatur metadata cadangan dengan komponen .
IVssComponent::SetBackupStamp

Metode SetBackupStamp menetapkan string yang berisi informasi yang menunjukkan kapan pencadangan terjadi.
IVssComponent::SetPostRestoreFailureMsg

Metode SetPostRestoreFailureMsg digunakan untuk membuat pesan yang menjelaskan kegagalan dalam memproses peristiwa PostRestore.
IVssComponent::SetPreRestoreFailureMsg

Metode SetPreRestoreFailureMsg digunakan untuk membuat pesan yang menjelaskan kegagalan dalam memproses peristiwa PreRestore.
IVssComponent::SetRestoreMetadata

Metode SetRestoreMetadata mengatur metadata khusus penulis untuk komponen saat ini.
IVssComponent::SetRestoreTarget

Metode SetRestoreTarget menetapkan target pemulihan (dalam hal enumerasi VSS_RESTORE_TARGET) untuk komponen saat ini.

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 vswriter.h (termasuk Vss.h, VsWriter.h)