INF DelProperty 指示詞
警告
如果您要建置通用或 Windows 驅動程式套件，則這個指示詞無效。 請參閱 使用通用 INF 檔案 和 開始開發 Windows 驅動程式。
DelProperty 指示詞會參考一或多個 INF 檔案區段，這些區段會刪除裝置實例、裝置安裝類別、裝置介面類別或裝置介面的裝置屬性。
[DDInstall] |
[DDInstall.CoInstallers] |
[ClassInstall32] |
[ClassInstall32.ntx86] |
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows)
[ClassInstall32.ntarm64] | (Windows 10 version 1709 and later versions of Windows)
[interface-install-section] |
[interface-install-section.nt] |
[interface-install-section.ntx86] |
[interface-install-section.ntia64] | (Windows XP and later versions of Windows)
[interface-install-section.ntamd64] | (Windows XP and later versions of Windows)
[interface-install-section.ntarm] | (Windows 8 and later versions of Windows)
[interface-install-section.ntarm64] | (Windows 10 version 1709 and later versions of Windows)
[add-interface-section]
DelProperty=del-property-section[,del-property-section]... (Windows Vista and later versions of Windows)
您可以在上述正式語法語句所示的任何區段下指定 DelProperty 指示詞。
DelProperty 指示詞所參考的 del-property-section 具有下列格式：
[del-property-section]
(property-name [ ,, flags [, value]]) | ({property-category-guid}, property-pid [ , flags [, value]])
(property-name [ ,, flags [, value]]) | ({property-category-guid}, property-pid [ , flags [, value]])
...
del-property-section 可以有任意數目的屬性名稱專案或屬性 GUID 專案，每一行各有一個。
項目
property-name
其中一個屬性名稱，代表裝置實例 驅動程式套件 屬性。 支援的屬性名稱與 INF AddProperty 指示詞之屬性名稱專案所描述的屬性名稱相同。
property-category-guid
識別屬性類別目錄的 GUID 值。 GUID 值可以是系統定義的 GUID，可識別系統定義的屬性類別目錄或識別自定義屬性類別目錄的自定義 GUID。 支援的 GUID 值與 INF AddProperty 指示詞之 property-category-guid 專案所述的值相同。
property-pid
屬性標識符，表示屬性類別目錄內的特定屬性，由 property-category-guid 值表示。 基於內部系統原因，屬性標識碼必須大於或等於兩個。
flags
選擇性的十六進位旗標值，可控制刪除作業。 唯一支援的旗標值如下：
0x00000001 （FLG_DELPROPERTY_MULTI_SZ_DELSTRING）
如果屬性數據類型是 DEVPROP_TYPE_STRING_LIST，作業會刪除所有字串，其中包含符合值專案值所提供字串的現有字串清單。 字元的案例不會在提供的字串與字串清單中的現有字串之間的比較中考慮。
value
如果屬性數據類型是DEVPROP_TYPE_STRING_LIST且旗標專案 是0x00000001，則 值 專案值會提供刪除作業用來搜尋現有字串清單中的相符字串，如果找到相符字串，刪除作業就會從現有的字元串清單中移除相符字串。
備註
一般而言，INF 檔案不應該用來刪除可能由系統元件或其他 INF 檔案設定的裝置屬性。 DelProperty 指示詞的主要用途是用於 INF 檔案中，該檔案會更新先前的裝置安裝，而且不再需要為先前裝置安裝設定的屬性。
del-property-section 名稱在 INF 檔案內必須是唯一的，但相同 INF 檔案中的多個 DelProperty指示詞可以參考區段名稱。 區段名稱必須遵循定義 INF 檔案一般語法規則中所述區段名稱的一般規則。
如需如何使用 DelProperty 指示詞的詳細資訊，請參閱使用 INF AddProperty 指示詞和 INF DelProperty 指示詞。
範例
下列 delete 屬性區段範例包含兩行專案：第一行專案包含刪除 DeviceModel 屬性的屬性名稱專案值，而第二行專案會從數據類型為DEVPROP_TYPE_STRING_LIST的自定義裝置屬性值中刪除字元串 “DeleteThisString”。 在第二行中 ，property-category-guid 專案值為 “c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e” ，屬性標識符 專案值為 “2”，而 旗標 專案值為 “0x00000001”
[SampleDelPropertySection]
DeviceModel
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 0x00000001, "DeleteThisString"