Direttiva INF UpdateIniFields
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 UpdateIniFields fa riferimento a una o più sezioni denominate in cui è possibile specificare modifiche con granularità fine nelle righe di un file INI.
[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)
UpdateIniFields=update-inifields-section[,update-inifields-section]...
Ogni sezione denominata a cui fa riferimento una direttiva UpdateIniFields ha il formato seguente:
[update-inifields-section]
ini-file,ini-section,profile-name[,old-field][,new-field][,flags]
...
Una sezione update-inifields-section può avere qualsiasi numero di voci determinato da INF-writer, ognuna su una riga separata.
whse.
ini-file
Specifica il nome di un file INI fornito nel supporto di origine e, in modo implicito, di un file INI da aggiornare nel computer di destinazione. 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 dei file INI specificati che contiene la riga da modificare.
profile-name
Specifica il nome della riga da modificare all'interno della sezione INI specificata. Per apportare una modifica di questa riga, è necessario specificare almeno una delle voci di campo precedente e/o nuovo campo .
vecchio campo
Specifica un campo esistente all'interno della riga specificata. Se new-field viene omesso da questa voce di sezione, questo campo viene eliminato dalla riga specificata. In caso contrario, il valore new-field specificato deve sostituire questo campo.
nuovo campo
Specifica una sostituzione per un determinato campo precedente o, se viene omesso un campo precedente, un'aggiunta alla riga specificata.
flags
Specifica (in bit 0) come interpretare il campo precedente-e/o il nuovo-campo se o entrambi contengono un asterisco (*), e/o (in bit 1) quale carattere separatore usare quando si accoda un determinato campo nuovo alla riga specificata, come indicato di seguito:
Bit zero = 0
Interpretare qualsiasi asterisco (*) nelle voci di campo precedente e/o di campo nuovo specificate letteralmente, non come carattere jolly, quando si cerca una corrispondenza nella riga specificata del file INI. Questo è il valore predefinito.
Bit zero = 1
Interpretare qualsiasi asterisco (*) nelle voci old-field e/o new-field specificate come carattere jolly durante la ricerca di una corrispondenza nella riga specificata del file INI.
Bit one = 0
Usare uno spazio come separatore quando si aggiunge la voce di nuovo campo specificata alla riga specificata del file INI. Questo è il valore predefinito.
Bit uno = 1
Usare una virgola (,) come separatore quando si aggiunge la voce di nuovo campo specificata alla riga specificata del file INI.
Osservazioni:
La direttiva UpdateIniFields non viene quasi mai specificata nei file INF per le installazioni in Windows perché non è necessario disporre di file INI nei supporti di distribuzione. Tuttavia, la direttiva UpdateIniFields è valida in qualsiasi sezione illustrata nell'istruzione di sintassi formale, nonché nelle sezioni definite dal writer INF a cui fa riferimento una direttiva AddInterface o a cui viene fatto riferimento in una sezione InterfaceInstall32.
Ogni nome di sezione update-inifields 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.
A differenza di una sezione a cui fa riferimento la direttiva UpdateInis, una sezione a cui fa riferimento UpdateIniFields sostituisce, aggiunge o elimina parti di una riga in una riga di file INI esistente anziché influire sull'intero valore di una determinata riga. In ogni voce di sezione è necessario specificare almeno uno dei valori old-field e/o new-field .
Eventuali commenti in una riga di file INI da modificare vengono rimossi perché potrebbero non essere applicabili dopo le modifiche apportate in base a questa sezione. Quando si cercano campi nella riga nei file INI, spazi, tabulazioni e virgole vengono interpretati come delimitatori di campo. Tuttavia, un carattere di spazio viene utilizzato come separatore predefinito quando un nuovo campo viene aggiunto a una riga.
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 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.