Metode IVssCreateExpressWriterMetadata::AddExcludeFiles (vswriter.h)
Mengecualikan kumpulan file (file atau file tertentu) yang mungkin disertakan secara implisit ketika komponen penulis ekspres dicadangkan.
Sintaks
HRESULT AddExcludeFiles(
[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.
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 diperiksa.
[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.
Nilai kembali
Berikut ini adalah kode pengembalian yang valid untuk metode ini.
Nilai | Makna |
---|---|
|
Operasi berhasil. |
|
Salah satu nilai parameter tidak valid. |
|
Pemanggil kehabisan memori atau sumber daya sistem lainnya. |
|
Dokumen XML tidak valid. Periksa log peristiwa untuk detailnya. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS. |
|
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
Penulis ekspres hanya mendukung sumber daya lokal—kumpulan file yang jalur absolutnya dimulai dengan spesifikasi volume lokal yang valid dan tidak dapat menjadi drive jaringan yang dipetakan. Oleh karena itu, input jalur (wszPath) ke AddExcludeFiles (setelah resolusi variabel lingkungan apa pun) harus dalam format ini. Misalnya, seringkali lebih mudah untuk menentukan komponen untuk menyertakan semua file dalam direktori tertentu dan kemudian menggunakan AddExcludeFiles untuk secara eksplisit menghapus beberapa file (misalnya, file sementara) dari cadangan.
Untuk informasi selengkapnya tentang mengecualikan file, lihat Mengecualikan Spesifikasi Daftar File.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 7 [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | vswriter.h (termasuk Vss.h, VsWriter.h) |
Pustaka | VssApi.lib |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk