Metode IFhConfigMgr::AddRemoveExcludeRule (fhcfg.h)

Menambahkan aturan pengecualian ke daftar pengecualian atau menghapus aturan dari daftar.

Catatan

IFhConfigMgr tidak digunakan lagi dan dapat diubah atau tidak tersedia dalam rilis mendatang.

Sintaks

HRESULT AddRemoveExcludeRule(
  [in] BOOL                       Add,
  [in] FH_PROTECTED_ITEM_CATEGORY Category,
  [in] BSTR                       Item
);

Parameter

[in] Add

Jika parameter ini TRUE, aturan pengecualian baru ditambahkan. Jika diatur ke FALSE, aturan pengecualian yang ada akan dihapus.

[in] Category

Menentukan jenis aturan pengecualian. Lihat enumerasi FH_PROTECTED_ITEM_CATEGORY untuk nilai yang mungkin.

[in] Item

Jalur folder atau nama pustaka atau GUID item tempat aturan pengecualian diterapkan.

Menampilkan nilai

S_OK pada keberhasilan, atau nilai HRESULT yang gagal pada kegagalan. Kemungkinan nilai HRESULT yang gagal menyertakan nilai yang ditentukan dalam file header FhErrors.h.

Keterangan

Cakupan perlindungan Riwayat File adalah kumpulan file yang dicadangkan oleh fitur Riwayat File. Ini berisi aturan inklusi dan aturan pengecualian. Aturan penyertaan menentukan file dan folder yang disertakan. Aturan pengecualian menentukan file dan folder yang dikecualikan.

Cakupan perlindungan default mencakup semua folder dari semua pustaka pengguna dan folder Kontak, Desktop, dan Favorit.

Aturan pengecualian lebih diutamakan daripada aturan inklusi. Dengan kata lain, jika aturan inklusi bertentangan dengan aturan pengecualian, fitur Riwayat File mengikuti aturan pengecualian.

Untuk mengurangi cakupan perlindungan, gunakan IFhConfigMgr::AddRemoveExcludeRule untuk menambahkan aturan pengecualian.

Metode ini dapat digunakan untuk menambahkan atau menghapus aturan pengecualian. Ini tidak dapat digunakan untuk mengubah aturan inklusi.

Pustaka pengguna dapat dijumlahkan dengan memanggil fungsi SHGetKnownFolderItem dan metode antarmuka IShellItem dan IEnumShellItems .

Folder dan pustaka standar ditentukan oleh GUID, diawali dengan tanda bintang. Misalnya, *a990ae9f-a03b-4e80-94bc-9912d7504104 menentukan pustaka Gambar. Untuk daftar folder dan pustaka standar dan GUID-nya, lihat dokumentasi KNOWNFOLDERID .

Pustaka kustom ditentukan berdasarkan nama. Folder ditentukan oleh jalur lengkapnya (misalnya, C:\Users\Public\Videos).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	fhcfg.h

Lihat juga

FH_PROTECTED_ITEM_CATEGORY

FhConfigMgr

IFhConfigMgr

IFhConfigMgr::GetIncludeExcludeRules