INF-DelProperty-Direktive

Eine DelProperty-Direktive verweist auf einen oder mehrere INF-Dateiabschnitte, die Geräteeigenschaften für eine Instanz eines Geräts, eine Geräteeinrichtungsklasse, eine Geräte-Schnittstellenklasse oder eine Geräteschnittstelle löschen.

[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)

Eine DelProperty-Direktive kann unter jedem der Abschnitte angegeben werden, die in der formalen Syntaxanweisung oben aufgeführt sind.

Ein del-property-section, der von einer DelProperty-Direktive referenziert wird, hat das folgende Format:

[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]])
...

Ein del-property-section kann eine beliebige Anzahl von property-name-Einträgen oder property-guid-Einträgen enthalten, die jeweils in einer eigenen Zeile stehen.

Entries

property-name
Einer der Eigenschaftsnamen, die die Eigenschaften der Instanz des Geräts Treibers und des Pakets darstellen. Die unterstützten Eigenschaftsnamen entsprechen denen, die für den Eintrag property-name der Direktive INF AddProperty beschrieben sind.

property-category-guid
Ein GUID-Wert, der die Eigenschaftskategorie identifiziert. Der GUID-Wert kann eine systemdefinierte GUID sein, die eine systemdefinierte Eigenschaftskategorie identifiziert, oder eine angepasste GUID, die eine angepasste Eigenschaftskategorie identifiziert. Die unterstützten GUID-Werte sind die gleichen, die für den Eintrag property-category-guid der Direktive INF AddProperty beschrieben sind.

property-pid
Ein Eigenschaftsbezeichner, der die spezifische Eigenschaft innerhalb der Eigenschaftskategorie angibt, die durch den Wert property-category-guid angegeben wird. Aus systeminternen Gründen muss ein Eigenschaftsbezeichner größer oder gleich zwei sein.

flags
Ein optionaler hexadezimaler Flag-Wert, der den Vorgang des Löschens steuert. Der einzige Flag-Wert, der unterstützt wird, ist wie folgt:

0x00000001 (FLG_DELPROPERTY_MULTI_SZ_DELSTRING)
Wenn der Datentyp der Eigenschaft DEVPROP_TYPE_STRING_LIST ist, löscht der Vorgang alle Zeichenfolgen mit der vorhandenen Zeichenfolgenliste, die mit der Zeichenfolge übereinstimmen, die durch den Werteingabewert geliefert wird. Die Groß- und Kleinschreibung eines Zeichens wird bei dem Vergleich zwischen der gelieferten Zeichenfolge und einer vorhandenen Zeichenfolge in der Zeichenfolgenliste nicht berücksichtigt.

value
Wenn der Datentyp der Eigenschaft DEVPROP_TYPE_STRING_LIST ist und der Eintrag flags 0x00000001 lautet, liefert der Eintrag value die Zeichenfolge, mit der der Löschvorgang nach übereinstimmenden Zeichenfolgen in der bestehenden Zeichenfolgenliste sucht. Wird eine übereinstimmende Zeichenfolge gefunden, entfernt der Löschvorgang die übereinstimmende Zeichenfolge aus der bestehenden Zeichenfolgenliste.

Hinweise

Allgemein sollte eine INF-Datei nicht dazu verwendet werden, Geräteeigenschaften zu löschen, die möglicherweise von einer Systemkomponente oder einer anderen INF-Datei festgelegt wurden. Der primäre Zweck der Direktive DelProperty ist die Verwendung in einer INF-Datei, die eine frühere Geräteinstallation aktualisiert und eine Eigenschaft, die für eine frühere Geräteinstallation festgelegt wurde, nicht mehr benötigt.

Ein del-property-section-Name muss innerhalb einer INF-Datei eindeutig sein, aber der Sektionsname kann von mehr als einer DelProperty-Direktive in derselben INF-Datei referenziert werden. Ein Abschnittsname muss den allgemeinen Regeln für die Definition von Abschnittsnamen entsprechen, die in Allgemeine Syntaxregeln für INF-Dateien beschrieben sind.

Weitere Informationen über die Verwendung der Direktive DelProperty finden Sie unter Verwendung der INF-Direktive AddProperty und der INF-Direktive DelProperty.

Beispiele

Das folgende Beispiel eines Eigenschaftsabschnitts zum Löschen enthält zwei Zeileneinträge: Der erste Zeileneintrag enthält einen property-name-Eintragswert, der die Eigenschaft DeviceModel löscht, und der zweite Zeileneintrag löscht die Zeichenfolge „DeleteThisString“ aus einem angepassten Eigenschaftswert für ein Gerät, dessen Datentyp DEVPROP_TYPE_STRING_LIST ist. In der zweiten Zeile lautet der Eintrag property-category-guid „c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e“, der Eintrag property-identifier hat den Wert „2“ und der Eintrag flags hat den Wert „0x00000001“.

[SampleDelPropertySection]
DeviceModel
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 0x00000001, "DeleteThisString"

Siehe auch

AddProperty