INF DelProperty 指示詞

警告

如果您要建置通用或 Windows 驅動程式套件，這個指示詞無效。 請參閱搭配 Windows 驅動程式使用通用 INF 檔案和 使用者入門。

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"

另請參閱

AddProperty