INF ProfileItems-Direktive

Achtung

Ab Windows 11 Version 22H2 ist ein Treiberpaket, das diese Direktive verwendet, nicht mehr für eine Signatur aus dem Hardware Developer Center berechtigt.

Universelle Treiberpakete und Windows-Treiber können diese Anweisung nicht verwenden.

Eine ProfileItems-Direktive wird in einem INF DDInstall-Abschnitt verwendet, um einen oder mehrere profile-items-sections aufzulisten, die Elemente oder Gruppen enthalten, die dem Startmenü hinzugefügt oder daraus entfernt werden sollen.

[DDInstall] 
 
ProfileItems=profile-items-section[,profile-items-section]...
...

Jeder benannte Abschnitt, auf den von einer ProfileItems-Direktive verwiesen wird, weist die folgende Form auf:

[profile-items-section]
 
Name=link-name[,name-attributes]
CmdLine=dirid,[subdir],filename
[SubDir=path]
[WorkingDir=wd-dirid,wd-subdir]
[IconPath=icon-dirid,[icon-subdir],icon-filename]
[IconIndex=index-value]
[HotKey=hotkey-value]
[Infotip=info-tip]
[DisplayResource="ResDllPath\ResDll",ResID]

Diese Anweisung wird in Windows XP und höheren Versionen von Windows unterstützt.

Einträge

Name=Linkname[,Name-Attribute]
Der Linkname gibt den Namen des Links für das Menüelement oder die Gruppe ohne .lnk-Erweiterung an. Dieser Wert kann eine Zeichenfolge oder ein %strkey%-Token sein, das in einem Strings-Abschnitt der INF-Datei definiert ist. Wenn kein DisplayResource-Eintrag angegeben wird, ist link-name auch die Anzeigezeichenfolge.

Der optionale Name-Attribute-Wert gibt mindestens ein Flag an, das sich auf den Vorgang im Menüelement auswirkt. Dieser Wert wird als ORed-Bitmaske von systemdefinierten Flagwerten ausgedrückt. Folgende Flags sind möglich:

0x00000001 (FLG_PROFITEM_CURRENTUSER)
Weist Windows an, ein Startmenüelement im Profil des aktuellen Benutzers zu erstellen oder zu löschen. Wenn dieses Flag nicht angegeben ist, verarbeitet Windows das Element für alle Benutzer.

0x00000002 (FLG_PROFITEM_DELETE)
Weist Windows an, das Menüelement zu löschen. Wenn dieses Flag nicht angegeben ist, wird das Element erstellt.

0x00000004 (FLG_PROFITEM_GROUP)
Weist Windows an, unter Start\Programme eine Startmenügruppe zu erstellen oder zu löschen. Wenn dieses Flag nicht angegeben ist, erstellt oder löscht Windows ein Menüelement, nicht eine Menügruppe.

Wenn kein Flag angegeben ist, erstellt Windows ein Menüelement für alle Benutzer.

CmdLine=dirid,[subdir],Dateiname
Die Dirid gibt einen Wert an, der das Verzeichnis identifiziert, in dem sich das Befehlsprogramm befindet. Beispielsweise gibt eine Dirid von 11 das Systemverzeichnis an. Die möglichen Dirid-Werte sind in der Beschreibung des Dirid-Werts im Abschnitt DestinationDirs aufgeführt.

Wenn eine untergeordnete Zeichenfolge vorhanden ist, befindet sich das Befehlsprogramm in einem Unterverzeichnis des Verzeichnisses, auf das von dirid verwiesen wird. Der Subdir gibt das Unterverzeichnis an. Wenn kein Subdir angegeben ist, befindet sich das Programm in dem Verzeichnis, auf das von dirid verwiesen wird.

Der Dateiname gibt den Namen des Programms an, das dem Menüelement zugeordnet ist.

SubDir=path
Dieser optionale Eintrag gibt ein Unterverzeichnis (Untermenü) unter Start\Programme an, in dem sich das Menüelement befindet. Wenn dieser Eintrag nicht angegeben wird, lautet der Pfad standardmäßig Start\Programme.

Wenn der Abschnitt profile-items-beispielsweise den Eintrag "Subdir=Accessories\Games" enthält, wird das Menüelement im Untermenü Start\Programs\Accessories\Games erstellt oder gelöscht.

Hinweis

Wenn FLG_PROFITEM_GROUP für name-attribute angegeben wird, wird der SubDir-Eintrag ignoriert.

WorkingDir=wd-dirid[;wd-subdir]
Dieser optionale Eintrag gibt ein Arbeitsverzeichnis für das Befehlsprogramm an. Wenn dieser Eintrag nicht angegeben wird, wird das Arbeitsverzeichnis standardmäßig auf das Verzeichnis festgelegt, in dem sich das Befehlsprogramm befindet.

Der wd-dirid-Wert identifiziert das Arbeitsverzeichnis. Listen mit möglichen Dirid-Werten finden Sie unter Verwenden von Dirids.

Die wd-subdir-Zeichenfolge gibt, sofern vorhanden, ein Unterverzeichnis von wd-dirid als Arbeitsverzeichnis an. Verwenden Sie diesen Parameter, um ein Verzeichnis ohne systemdefinierte Dirid anzugeben. Wenn dieser Parameter nicht angegeben wird, gibt allein der wd-dirid-Wert das Arbeitsverzeichnis an.

IconPath=icon-dirid,[icon-subdir],icon-filename
Dieser optionale Eintrag gibt den Speicherort einer Datei an, die ein Symbol für das Menüelement enthält.

Die icon-dirid-Zeichenfolge identifiziert das Verzeichnis für die DLL, die das Symbol enthält. Listen mit möglichen Dirid-Werten finden Sie unter Verwenden von Dirids.

Der Wert icon-subdir gibt an, dass sich die DLL in einem Unterverzeichnis von icon-dirid befindet. Der Wert icon-subdir gibt das Unterverzeichnis an.

Der Wert icon-filename gibt die DLL an, die das Symbol enthält.

Wenn dieser Eintrag nicht angegeben wird, sucht Windows nach einem Symbol in der Datei, die im CmdLine-Eintrag angegeben ist.

IconIndex=index-value
Dieser optionale Eintrag gibt an, welches Symbol in einer DLL für das Menüelement verwendet werden soll. Informationen zum Indizieren der Symbole in einer DLL finden Sie in der Microsoft Windows SDK Dokumentation.

Wenn ein IconPath-Eintrag angegeben wird, wird der Indexwert in diese DLL eingefügt. Andernfalls wird dieser Wert in die datei indiziert, die im CmdLine-Eintrag angegeben ist.

HotKey=hotkey-value
Dieser optionale Eintrag gibt eine Tastaturbeschleunigung für das Menüelement an.

Weitere Informationen zu Hot Keys finden Sie in der Dokumentation zum Windows SDK.

Infotip=info-tip
Dieser optionale Eintrag gibt einen Informationstipp für das Menüelement an.

Dieser Wert kann eine Zeichenfolge oder ein %strkey%-Token sein, das in einem Strings-Abschnitt der INF-Datei definiert ist.

Der Info-Tipp-Wert kann auch als "@ResDllPath\ResDll,-ResID" angegeben werden, wobei ResDllPath und ResDll den Pfad und Dateinamen einer Ressourcen-DLL angeben und -resID ein negativer Wert ist, der eine Ressourcen-ID darstellt.

Verwenden Sie dieses Format, um windows Multilingual User Interface (MUI) zu unterstützen. Beispiel:

InfoTip = "@%11%\shell32.dll,-22531"

DisplayResource="ResDllPath\ResDll",ResID
Dieser optionale Eintrag gibt eine Zeichenfolgenressource an, die eine lokalisierbare Zeichenfolge identifiziert, die im Startmenü als Anzeigename für die Verknüpfung oder Gruppe verwendet werden soll.

ResDllPath und ResDll geben den Pfad und Dateinamen einer Ressourcen-DLL an, und resID ist ein positiver Wert, der eine Ressourcen-ID darstellt. Beispiel:

DisplayResource="%11%\shell32.dll",22019

Verwenden Sie diesen Eintrag, um Windows Multilingual User Interface (MUI) zu unterstützen. Wenn dieser Eintrag nicht verwendet wird, wird die im Eintrag Name angegebene Zeichenfolge angezeigt.

Hinweise

Ein bestimmter Profile-items-section-Name muss innerhalb der INF-Datei eindeutig sein und muss den allgemeinen Regeln zum Definieren von Abschnittsnamen entsprechen. Weitere Informationen zu diesen Regeln finden Sie unter Allgemeine Syntaxregeln für INF-Dateien.

Jeder Abschnitt profile-items-enthält ausführliche Informationen zum Erstellen oder Entfernen eines Startmenüelements oder einer Gruppe. Um mehr als ein Menüelement oder eine Gruppe aus einem INF zu bearbeiten, erstellen Sie mehrere profile-items-section , und listen Sie die Abschnitte in der ProfileItems-Direktive auf .

Alle Zeichenfolgenparameter, die in den Profile-items-Section-Einträgen angegeben sind, können mithilfe eines %strkey%-Tokens angegeben werden, wie unter Allgemeine Syntaxregeln für INF-Dateien beschrieben.

Beispiele

Der folgende INF-Dateiauszug zeigt, wie Sie den Abschnitt profile-items-verwenden , um rechner zum Startmenü hinzuzufügen.

[CalcInstallItems]
Name = %Calc_DESC%
CmdLine = 11,, calc.exe
SubDir = %Access_GROUP%
WorkingDir = 11
InfoTip = %Calc_TIP%
:
:
[Strings]
AccessGroup = "Accessories"
Calc_DESC = "Calculator"
Calc_TIP = "Performs basic arithmetic tasks with an on-screen calculator"

Der folgende INF-Dateiauszug zeigt, wie Sie dieselbe Software mithilfe des Eintrags DisplayResource installieren, um lokalisierte Menüelemente zu erstellen.

[CalcInstallItems]
Name = %Calc_DESC%
CmdLine = 11,, calc.exe
SubDir = %Access_GROUP%
WorkingDir = 11
InfoTip = "@%11%\shell32.dll,-22531"
DisplayResource="%11%\shell32.dll",22019
:
:
[Strings]
Access_GROUP = "Accessories"
Calc_DESC = "Calculator"

Weitere Informationen

DDInstall