Direttiva INI2Reg INF
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 Ini2Reg fa riferimento a una o più sezioni denominate in cui le righe o le sezioni di un file INI fornito vengono spostate nel Registro di sistema. In questo modo viene creata o sostituita una o più voci di valore in una chiave specificata.
[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)
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Ogni sezione denominata a cui fa riferimento una direttiva Ini2Reg ha il formato seguente:
[ini-to-registry-section]
ini-file,ini-section,[ini-key],reg-root,subkey[,flags]
...
Una sezione ini-to-registry può avere qualsiasi numero di voci determinato da INF,ognuna in una riga separata.
whse.
ini-file
Specifica il nome di un file INI fornito nel supporto di origine. Questo valore può essere espresso come nome file o come token %strkey% definito in una sezione Strings del file INF.
ini-section
Specifica il nome della sezione all'interno del file INI specificato che contiene le informazioni del Registro di sistema da copiare.
ini-key
Specifica il nome della chiave nel file INI da copiare nel Registro di sistema. Se questo valore viene omesso, l'intera sezione ini deve essere trasferita alla sottochiave del Registro di sistema specificata.
reg-root
Identifica la radice dell'albero del Registro di sistema per altri valori forniti in questa voce. Per informazioni specifiche, vedere il riferimento per la direttiva AddReg.
sottochiave
Identifica la sottochiave per ricevere il valore, espresso come token %strkey% definito in una sezione Strings dell'INF o come percorso esplicito del Registro di sistema (key1\key2\key3...) dalla radice reg specificata.
flags
Specifica (in bit 0) come gestire il file INI dopo il trasferimento delle informazioni specificate nel Registro di sistema e/o (in bit 1) se sovrascrivere le informazioni esistenti del Registro di sistema, come indicato di seguito:
Bit zero = 0
Non rimuovere le informazioni specificate dal file INI dopo averlo copiato nel Registro di sistema. Si tratta dell'impostazione predefinita.
Bit zero = 1
Eliminare le informazioni specificate dal file INI dopo averlo spostato nel Registro di sistema.
Bit one = 0
Se la sottochiave specificata esiste già nel Registro di sistema, non trasferire le informazioni fornite da INI in questa sottochiave. In caso contrario, creare la sottochiave specificata nel Registro di sistema con le informazioni fornite da INI come voce di valore. Si tratta dell'impostazione predefinita.
Bit uno = 1
Se la sottochiave specificata esiste già nel Registro di sistema, sostituire la voce di valore con le informazioni fornite da INI.
Osservazioni:
La direttiva Ini2Reg è valida in qualsiasi sezione illustrata nell'istruzione di sintassi formale. Questa direttiva è valida anche nelle sezioni definite dal writer INF a cui fa riferimento una direttiva AddInterface o a cui viene fatto riferimento in una sezione InterfaceInstall32.
Se viene usato un file INF per installare i dispositivi in Windows XP e versioni successive di Windows, il file INF non deve contenere direttive Ini2Reg . I file INF che contengono direttive Ini2Reg non supereranno il test del logo "Progettato per Windows", non riceveranno una firma digitale e pertanto non saranno attendibili da Windows (vedere How Windows Selects Drivers).
Ogni nome ini-to-registry-section deve essere univoco per il file INF. Ogni nome di sezione creato da INF-writer 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.
L'INF fornisce il percorso completo del file ini specificato nel supporto di distribuzione in uno dei modi seguenti:
Nei file INF forniti da IHV/OEM, usando le sezioni SourceDisksNames e, possibilmente, SourceDisksFiles di questo INF, per specificare in modo esplicito il percorso completo di ogni file di origine denominato che non si trova nella directory radice (o directory) nel supporto di distribuzione.
Nei file INF forniti dal sistema specificando uno o più file INF aggiuntivi, identificati nella voce LayoutFile nella sezione Versione del file INF.