IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot method (vswriter.h)

  • Artikel

Melaporkan kumpulan file apa pun yang akan secara eksplisit dikecualikan oleh penulis saat salinan bayangan dibuat.

Memanggil metode ini tidak menyebabkan file dikecualikan. Penulis bertanggung jawab untuk menghapus file dari salinan bayangan dalam metode CVssWriter::OnPostSnapshot .

Sintaks

HRESULT AddExcludeFilesFromSnapshot(
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] bool    bRecursive
);

Parameter

[in] wszPath

Penunjuk ke string karakter lebar yang dihentikan null yang berisi direktori akar tempat file akan dikecualikan.

Direktori dapat menjadi direktori lokal pada komputer VSS, atau dapat menjadi direktori berbagi file di server file jarak jauh.

Jalur UNC didukung.

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

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

[in] wszFilespec

Penunjuk ke string karakter lebar yang dihentikan null yang berisi spesifikasi file file yang akan dikecualikan.

Spesifikasi file tidak boleh berisi spesifikasi direktori (misalnya, tidak ada garis miring terbelakang) tetapi dapat berisi ? dan * karakter kartubebas.

[in] bRecursive

Nilai Boolean yang menentukan apakah jalur yang ditentukan oleh parameter wszPath hanya mengidentifikasi satu direktori atau jika menunjukkan hierarki direktori yang akan dilalui secara rekursif. Parameter ini harus diatur ke true jika jalur diperlakukan sebagai hierarki direktori yang akan diulang, atau salah sebaliknya.

Untuk informasi tentang melintasi folder yang dipasang, lihat Bekerja dengan Folder terpasang dan Reparse Points.

Mengembalikan nilai

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai Makna
S_OK
0x00000000L
 Operasi berhasil.
E_INVALIDARG
0x80070057L
 Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY
0x8007000EL
 Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_INVALID_XML_DOCUMENT
0x80042311L
 Dokumen XML tidak valid. Periksa log peristiwa untuk detailnya. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.
VSS_E_NOT_SUPPORTED
0x8004232FL
 Metode ini tidak didukung untuk penulis ekspres.
VSS_E_UNEXPECTED
 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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP, dan Windows Server 2003: Berbagi file jarak jauh tidak didukung hingga Windows 8 dan Windows Server 2012.

Penggunaan metode AddExcludeFilesFromSnapshot bersifat opsional. Penulis harus menggunakan metode ini hanya untuk file besar yang berubah secara signifikan di antara operasi salinan bayangan.

Metode ini bukan pengganti metode IVssCreateWriterMetadata::AddExcludeFiles . Penulis harus terus menggunakan metode AddExcludeFiles untuk melaporkan kumpulan file mana yang dikecualikan dari cadangan.

Pemanggil bertanggung jawab untuk memanggil metode IUnknown::Release untuk merilis sumber daya objek IVssWMFiledesc yang dikembalikan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header vswriter.h (termasuk Vss.h, VsWriter.h)
Pustaka VssApi.lib

Lihat juga

IVssCreateWriterMetadata::AddExcludeFiles

IVssCreateWriterMetadataEx

IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotCount

IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotFile