Direttiva INF ProfileItems
Attenzione
A partire da Windows 11 versione 22H2, un pacchetto driver che usa questa direttiva non è più idoneo per una firma da Hardware Developer Center.
I pacchetti driver universali e i driver di Windows non possono usare questa direttiva.
Una direttiva ProfileItems viene utilizzata in una sezione INF DDInstall per elencare una o più sezioni di elementi del profilo contenenti elementi o gruppi a cui aggiungere o rimuovere il menu Start.
[DDInstall]
ProfileItems=profile-items-section[,profile-items-section]...
...
Ogni sezione denominata a cui fa riferimento una direttiva ProfileItems ha il formato seguente:
[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]
Questa direttiva è supportata in Windows XP e versioni successive di Windows.
whse.
Name=link-name[,name-attributes]
Il nome del collegamento specifica il nome del collegamento per la voce di menu o il gruppo, senza l'estensione .lnk . Questo valore può essere una stringa o un token %strkey% definito in una sezione Strings del file INF. Se non viene specificata una voce DisplayResource , anche il nome del collegamento è la stringa di visualizzazione.
Il valore facoltativo name-attributes specifica uno o più flag che influiscono sull'operazione nella voce di menu. Questo valore è espresso come maschera di bit ORed di valori di flag definiti dal sistema. I flag possibili includono quanto segue:
0x00000001 (FLG_PROFITEM_CURRENTUSER)
Indirizza Windows a creare o eliminare un elemento menu Start nel profilo dell'utente corrente. Se questo flag non è specificato, Windows elabora l'elemento per tutti gli utenti.
0x00000002 (FLG_PROFITEM_DELETE)
Indica a Windows di eliminare la voce di menu. Se questo flag non viene specificato, viene creato l'elemento.
0x00000004 (FLG_PROFITEM_GROUP)
Indica a Windows di creare o eliminare un gruppo di menu Start in Start\Programmi. Se questo flag non è specificato, Windows crea o elimina una voce di menu, non un gruppo di menu.
Se non viene specificato alcun flag, Windows crea una voce di menu per tutti gli utenti.
CmdLine=dirid,[subdir],filename
Il dirid specifica un valore che identifica la directory in cui risiede il programma di comando. Ad esempio, un dirido 11 indica la directory di sistema. I possibili valori dirid sono elencati nella descrizione del valore dirid nella sezione DestinationDirs .
Se è presente una stringa subdir , il programma di comando si trova in una sottodirectory della directory a cui fa riferimento dirid. Il sottodir specifica la sottodirectory. Se non viene specificato alcun sottodir , il programma si trova nella directory a cui fa riferimento dirid.
Il nome file specifica il nome del programma associato alla voce di menu.
SubDir=path
Questa voce facoltativa specifica una sottodirectory (sottomenu) in Start\Programs in cui risiede la voce di menu. Se questa voce viene omessa, il percorso predefinito è Start\Programs.
Ad esempio, se la sezione profile-items-section contiene la voce "Subdir=Accessories\Games", la voce di menu viene creata o eliminata nel sottomenu Start\Programs\Accessories\Games.
Nota
Se FLG_PROFITEM_GROUP viene specificato per gli attributi nome, la voce SubDir viene ignorata.
WorkingDir=wd-dirid[,wd-subdir]
Questa voce facoltativa specifica una directory di lavoro per il programma di comando. Se questa voce viene omessa, per impostazione predefinita la directory di lavoro viene impostata sulla directory in cui risiede il programma di comando.
Il valore wd-dirid identifica la directory di lavoro. Per gli elenchi di possibili valori dirid , vedere Uso di Dirids.
La stringa wd-subdir , se presente, specifica una sottodirectory di wd-dirid come directory di lavoro. Usare questo parametro per specificare una directory che non dispone di un dirid definito dal sistema. Se questo parametro viene omesso, il valore wd-dirid specifica da solo la directory di lavoro.
IconPath=icon-dirid,[icon-subdir],icon-filename
Questa voce facoltativa specifica il percorso di un file che contiene un'icona per la voce di menu.
La stringa a forma di icona identifica la directory per la DLL che contiene l'icona. Per gli elenchi di possibili valori dirid , vedere Uso di Dirids.
Il valore icon-subdir , se presente, indica che la DLL si trova in una sottodirectory di icon-dirid. Il valore icon-subdir specifica la sottodirectory.
Il valore icon-filename specifica la DLL che contiene l'icona.
Se questa voce viene omessa, Windows cerca un'icona nel file specificato nella voce CmdLine .
IconIndex=index-value
Questa voce facoltativa specifica quale icona in una DLL usare per la voce di menu. Per informazioni su come indicizzare le icone in una DLL, vedere la documentazione di Microsoft Windows SDK.
Se viene specificata una voce IconPath , il valore di indice viene indicizzato nella DLL. In caso contrario, questo valore viene indicizzato nel file specificato nella voce CmdLine .
HotKey=hotkey-value
Questa voce facoltativa specifica un acceleratore di tastiera per la voce di menu.
Per altre informazioni sui tasti di scelta rapida, vedere la documentazione di Windows SDK.
Infotip=info-tip
Questa voce facoltativa specifica una descrizione informativa per la voce di menu.
Questo valore può essere una stringa o un token %strkey% definito in una sezione Strings del file INF.
Il valore info-tip può essere specificato anche come "@ResDllPath\ResDll,-ResID", dove ResDllPath e ResDll specificano il percorso e il nome file di una DLL di risorsa e -resID è un valore negativo che rappresenta un ID risorsa.
Usa questo formato per supportare Windows interfaccia utente multilingue (MUI). ad esempio:
InfoTip = "@%11%\shell32.dll,-22531"
DisplayResource="ResDllPath\ResDll",ResID
Questa voce facoltativa specifica una risorsa stringa che identifica una stringa localizzabile da usare nella menu Start come nome visualizzato per il collegamento o il gruppo.
ResDllPath e ResDll specificano il percorso e il nome file di una DLL di risorsa e resID è un valore positivo che rappresenta un ID risorsa. ad esempio:
DisplayResource="%11%\shell32.dll",22019
Usare questa voce per supportare Windows interfaccia utente multilingue (MUI). Se questa voce non viene utilizzata, viene visualizzata la stringa specificata dalla voce Nome .
Osservazioni:
Un determinato nome di sezione profile-items deve essere univoco all'interno del file INF e deve seguire le regole generali per la definizione dei nomi di sezione. Per altre informazioni su queste regole, vedere Regole di sintassi generali per i file INF.
Ogni sezione profile-items-section contiene informazioni dettagliate per la creazione o la rimozione di un menu Start elemento o gruppo. Per modificare più voci di menu o gruppo da un INF, creare più di una sezione di elementi del profilo ed elencare le sezioni nella direttiva ProfileItems .
È possibile specificare uno dei parametri stringa specificati nelle voci della sezione profile-items usando un token %strkey%, come descritto in Regole di sintassi generali per i file INF.
Esempi
L'estratto di file INF seguente illustra come usare la sezione profile-items-section per aggiungere Calculator al menu Start.
[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"
L'estratto di file INF seguente illustra come installare lo stesso software usando la voce DisplayResource per creare voci di menu localizzate.
[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"