Metode IVssComponent::AddPartialFile (vswriter.h)

Artikel
03/08/2023

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

Hanya penulis yang dapat memanggil metode ini, dan hanya selama operasi pencadangan.

Sintaks

HRESULT AddPartialFile(
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilename,
  [in] LPCWSTR wszRanges,
  [in] LPCWSTR wszMetadata
);

Parameter

[in] wszPath

String karakter lebar yang dihentikan null yang berisi jalur file yang terlibat dalam operasi file parsial.

Jalur dapat berisi variabel lingkungan (misalnya, %SystemRoot%) tetapi tidak dapat berisi karakter kartubebas.

Tidak ada persyaratan bahwa jalur berakhir dengan garis miring terbelakang (""). Terserah aplikasi yang mengambil informasi ini untuk diperiksa.

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] wszFilename

String karakter lebar yang dihentikan null yang berisi nama file yang terlibat dalam operasi file parsial. Nama file (wszFilename) tidak boleh berisi karakter kartubebas (* atau ?) dan harus konsisten dengan spesifikasi file dari set file yang berisi jalur sumber (wszPath).

[in] wszRanges

String karakter lebar yang dihentikan null yang berisi daftar offset dan panjang file yang membentuk rentang dukungan file parsial (bagian file yang benar-benar akan dicadangkan), atau nama file yang berisi daftar tersebut.

Menentukan rentang dukungan file parsial diperlukan, dan nilai ini tidak boleh NULL.

[in] wszMetadata

String karakter lebar yang dihentikan null yang berisi metadata tambahan yang diperlukan oleh penulis untuk memvalidasi operasi pemulihan file parsial. Informasi dalam string metadata ini akan buram bagi pemohon.

Jika metadata tambahan tidak diperlukan, nilai ini bisa NULL.

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, tidak dipanggil selama operasi pemulihan.

Keterangan

Hanya penulis yang dapat memanggil metode ini, dan penulis tidak dapat memanggil metode ini selama operasi pemulihan.

Sintaks daftar rentang (wszRanges) 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.

Jika wszRange mengacu pada file yang berisi semua offset dan panjang (file rentang), wszRange hanya akan berisi jalur lengkap ke file.

File rentang harus berupa file biner dengan format berikut:

Bilangan bulat 64-bit yang menunjukkan jumlah rentang file berbeda yang perlu dicadangkan
Setiap rentang dinyatakan sebagai sepasang bilangan bulat 64-bit: offset ke dalam file yang dicadangkan dalam byte, dan panjang data mulai dari offset tersebut untuk dicadangkan

Dalam kedua kasus, rentang menunjukkan subbagian file tertentu yang akan dicadangkan, terlepas dari sisa file.

Pemohon dapat mengambil informasi file parsial menggunakan IVssComponent::GetPartialFile dan menggunakan informasi offset dan panjang yang dikembalikan oleh GetPartialFile untuk memulihkan bagian yang dicadangkan ke lokasi yang sesuai dalam salinan file pada disk pada waktu pemulihan.

AddPartialFile dapat diterapkan ke file yang sudah dikelola oleh komponen (atau salah satu subkomponennya jika komponen menentukan set komponen), atau dapat menambahkan file baru ke komponen dan menunjukkan bahwa ia akan berpartisipasi dalam operasi file parsial.

Ketika menunjukkan bahwa file yang akan berpartisipasi adalah file baru, file tersebut harus ada pada volume yang disalin bayangan dan jalurnya (wszPath) harus cocok atau berada di bawah jalur yang sudah ada di komponen (atau salah satu subkomponennya jika komponen menentukan set komponen). Namun, spesifikasi file file (wszFileSpec) tidak boleh cocok dengan yang ada di komponen.

File yang baru ditambahkan tidak akan mendukung pemetaan lokasi alternatif.

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

IVssBackupComponents::SetRangesFilePath

IVssComponent

IVssComponent::GetPartialFile

IVssComponent::GetPartialFileCount