Metode IVssComponent::GetDirectedTarget (vswriter.h)

Artikel
08/27/2023

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. File dapat dipulihkan ke target pemulihan baru dan/atau rentang datanya yang dipulihkan ke lokasi yang berbeda dengan target pemulihan.

Penulis atau pemohon dapat memanggil metode ini.

Sintaks

HRESULT GetDirectedTarget(
  [in]  UINT iDirectedTarget,
  [out] BSTR *pbstrSourcePath,
  [out] BSTR *pbstrSourceFileName,
  [out] BSTR *pbstrSourceRangeList,
  [out] BSTR *pbstrDestinationPath,
  [out] BSTR *pbstrDestinationFilename,
  [out] BSTR *pbstrDestinationRangeList
);

Parameter

[in] iDirectedTarget

Jumlah indeks target yang diarahkan. Nilai parameter ini adalah bilangan bulat dari 0 hingga n–1 inklusif, di mana n adalah jumlah total target yang diarahkan yang terkait dengan komponen tertentu (dan subkomponennya jika menentukan set komponen). Nilai n dikembalikan oleh IVssComponent::GetDirectedTargetCount.

[out] pbstrSourcePath

Alamat variabel yang dialokasikan pemanggil yang menerima string yang berisi jalur ke direktori yang pada waktu pencadangan 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).

[out] pbstrSourceFileName

Alamat variabel yang dialokasikan pemanggil yang menerima string yang berisi nama file (pada waktu pencadangan) yang akan dipetakan ulang selama pemulihan (file sumber). Nama file ini tidak boleh berisi karakter kartubebas apa pun, dan harus menjadi anggota set file yang sama dengan jalur sumber (pbstrSourcePath).

[out] pbstrSourceRangeList

Alamat variabel yang dialokasikan pemanggil yang menerima string yang berisi daftar offset dan panjang file yang dipisahkan koma yang menunjukkan rentang dukungan file sumber (bagian file yang akan dipulihkan).

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

[out] pbstrDestinationPath

Alamat variabel yang dialokasikan penelepon yang menerima string yang berisi jalur tempat data file sumber akan dipetakan ulang pada waktu pemulihan.

[out] pbstrDestinationFilename

Alamat variabel yang dialokasikan penelepon yang menerima string yang berisi nama file tempat data file sumber akan dipetakan ulang pada waktu pemulihan.

[out] pbstrDestinationRangeList

Alamat variabel yang dialokasikan penelepon yang menerima string yang berisi daftar offset file yang dipisahkan koma dan panjang yang menunjukkan rentang dukungan file tujuan (lokasi tempat bagian file sumber akan dipulihkan).

Jumlah dan panjang rentang dukungan file tujuan harus cocok 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 mengembalikan nilai atribut.
E_INVALIDARG	Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY	Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_INVALID_XML_DOCUMENT	Dokumen XML tidak valid. Periksa log peristiwa untuk detailnya. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.
VSS_E_OBJECT_NOT_FOUND	Item yang ditentukan tidak ditemukan.

Keterangan

Jika panggilan ke GetDirectedTarget berhasil, pemanggil bertanggung jawab untuk membebaskan setiap string yang dikembalikan dengan memanggil fungsi SysFreeString .

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

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

File yang target yang diarahkan dikembalikan oleh GetDirectedTarget mungkin merupakan anggota file komponen saat ini atau subkomponen apa pun yang ditentukannya.

Pemanggil harus membebaskan memori yang dipegang oleh parameter pbstrSourcePath, pbstrSourceFileName, pbstrSourceRangeList, pbstrDestinationPath, pbstrDestinationFilename, dan pbstrDestinationRangeList dengan memanggil SysFreeString.

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.

Pemohon perlu memeriksa apakah file sumber target yang diarahkan dicadangkan sebagai file parsial untuk mengimplementasikan pemulihan dengan benar. Jika demikian, pemohon menggunakan informasi target yang diarahkan bersama dengan informasi file parsial (IVssComponent::GetPartialFile) untuk mengimplementasikan pemecahan ulang 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::AddDirectedTarget

IVssComponent::GetDirectedTargetCount

Bagikan melalui