Metode IVssComponent::AddDirectedTarget (vswriter.h)

Artikel
03/08/2023

Metode AddDirectedTarget memungkinkan penulis untuk menunjukkan pada waktu pemulihan bahwa ketika file akan dipulihkan, itu (file sumber) harus dipetakan ulang. File dapat dipulihkan ke lokasi pemulihan baru dan/atau rentang datanya yang dipulihkan ke offset yang berbeda dalam lokasi pemulihan.

Metode ini hanya dapat dipanggil oleh penulis selama operasi pemulihan.

Metode ini tidak dapat dipanggil saat menangani peristiwa BackupComplete (CVssWriter::OnBackupComplete) atau BackupShutdown (CVssWriter::OnBackupShutdown).

Sintaks

HRESULT AddDirectedTarget(
  [in] LPCWSTR wszSourcePath,
  [in] LPCWSTR wszSourceFilename,
  [in] LPCWSTR wszSourceRangeList,
  [in] LPCWSTR wszDestinationPath,
  [in] LPCWSTR wszDestinationFilename,
  [in] LPCWSTR wszDestinationRangeList
);

Parameter

[in] wszSourcePath

String karakter lebar yang dihentikan null yang berisi jalur ke direktori pada waktu pemulihan yang berisi file yang akan dipulihkan (file sumber). Jalur ini harus cocok atau berada di bawah jalur set file yang sudah ada di komponen (atau salah satu subkomponennya jika komponen menentukan set komponen).

[in] wszSourceFilename

String karakter lebar yang dihentikan null yang berisi nama file (pada waktu pencadangan) yang akan dipetakan ulang pada waktu pemulihan (file sumber). Nama file (wszSourceFilename) tidak boleh berisi karakter kartubebas (* atau ?) dan harus konsisten dengan spesifikasi file dari set file yang berisi jalur sumber (wszSourcePath).

[in] wszSourceRangeList

String karakter lebar yang dihentikan null yang berisi daftar offset dan panjang file yang dipisahkan koma yang menunjukkan rentang dukungan file sumber (bagian file yang benar-benar akan dipulihkan).

Jumlah dan panjang rentang dukungan file sumber harus sesuai dengan jumlah dan ukuran rentang dukungan file tujuan.

[in] wszDestinationPath

String karakter lebar yang dihentikan null yang berisi jalur tempat data file sumber akan dipetakan ulang pada waktu pemulihan.

[in] wszDestinationFilename

String karakter lebar yang dihentikan null yang berisi nama file tempat data file sumber akan dipetakan ulang pada waktu pemulihan. Nama file (wszDestinationFilename) tidak boleh berisi karakter kartubebas (* atau ?).

[in] wszDestinationRangeList

String karakter lebar yang dihentikan null yang berisi daftar offset dan panjang file yang dipisahkan koma yang menunjukkan rentang dukungan file tujuan (lokasi tempat bagian file sumber akan dipulihkan).

Jumlah dan panjang rentang dukungan file tujuan harus sesuai dengan jumlah dan ukuran rentang dukungan file sumber.

Mengembalikan nilai

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai	Makna
S_OK	Berhasil mengatur item.
E_INVALIDARG	Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY	Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_BAD_STATE	Metode ini tidak dipanggil oleh penulis atau, jika dipanggil oleh penulis, metode ini tidak dipanggil selama operasi pemulihan atau dipanggil saat menangani peristiwa BackupComplete atau BackupShutdown .

Keterangan

Hanya penulis yang dapat memanggil AddDirectedTarget, dan hanya selama operasi pemulihan.

Pemohon akan menggunakan informasi target yang diarahkan yang disimpan dalam Dokumen Komponen Cadangan hanya jika target pemulihan VSS_RT_DIRECTED.

Metode AddDirectedTarget dapat diterapkan ke file apa pun yang dikelola dalam komponen saat ini atau, jika komponen menentukan set komponen, di salah satu subkomponen yang tidak dapat dipilih.

Spesifikasi file sumber dan tujuan dapat menunjuk ke file yang sama. Ini akan memungkinkan pemeriksaan ulang file ke dalam dirinya sendiri pada waktu pemulihan.

Sintaks daftar rentang (wszSourceRanges dan wszDestinationRanges) adalah daftar yang dipisahkan koma dari bentuk offset1:length1, offset2:length2, di mana setiap offset dan panjang adalah bilangan bulat 64-bit yang masing-masing menentukan offset byte dan panjang dalam byte. Offset dan panjang dapat diekspresikan baik sebagai nilai heksadesimal atau desimal.

Jumlah entri dan ukurannya harus cocok dalam argumen rentang sumber dan tujuan.

AddDirectedTarget dapat menggunakan sebagai file sumbernya file apa pun yang sudah dikelola oleh komponen atau salah satu subkomponennya jika komponen menentukan set komponen.

File parsial dapat ditambahkan sebagai target yang diarahkan, jika rentang file parsial yang akan dicadangkan cocok dengan rentang sumber target yang diarahkan (lihat IVssComponent::AddPartialFile). Ini akan memungkinkan Anda untuk memetakan ulang sebagian file pada waktu pemulihan.

Dalam hal ini, pemohon mengambil informasi target yang diarahkan dengan memanggil metode IVssComponent::GetDirectedTarget dan menggunakannya untuk mengimplementasikan pemindahan data yang dicadangkan selama pemulihan.

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)
Pustaka	VssApi.lib

Lihat juga

IVssComponent

IVssComponent::GetDirectedTarget

IVssComponent::GetDirectedTargetCount