Condividi tramite


Direttiva INF UpdateInis

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 UpdateInis fa riferimento a una o più sezioni denominate, specificando un file INI da cui deve essere letta e applicata una particolare sezione o riga a un file INI esistente con lo stesso nome nel computer di destinazione. Facoltativamente, le modifiche line-by-line da e a tali file INI possono essere specificate nella sezione update-ini-section.

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

UpdateInis=update-ini-section[,update-ini-section]...

Questa direttiva non viene quasi mai specificata nei file INF per l'installazione in Windows, a causa della mancanza di necessità per i file INI. Tuttavia, la direttiva UpdateInis è 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 sezione denominata a cui fa riferimento una direttiva UpdateInis ha il formato seguente:

[update-ini-section]
 
ini-file,ini-section[,old-ini-entry][,new-ini-entry][,flags]
...

Una sezione update-ini-section 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 e, in modo implicito, quello del 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 del file INI specificato. Se vengono specificati i due valori successivi, questa sezione contiene una voce da modificare. Se viene omessa una voce precedente, ma viene fornita una nuova voce , la nuova voce deve essere aggiunta man mano che questa sezione viene letta.

old-ini-entry
Questo valore facoltativo specifica il nome di una voce nella sezione specificata, espressa in genere nel formato seguente:

"key=value"

Entrambi i token chiave e valore possono essere espressi come token %strkey% definiti in una sezione Stringhe del file INF. L'asterisco (*) può essere specificato come carattere jolly per la chiave o il valore.

new-ini-entry
Questo valore facoltativo specifica una modifica a una determinata voce precedente o all'aggiunta di una nuova voce. Questo valore può essere espresso allo stesso modo di old-ini-entry.

flags
Questo valore facoltativo controlla l'interpretazione della voce precedente e/o nuova voce specificata. La voce flags può essere uno dei valori numerici seguenti:

Valore Significato
0 Questo è il valore predefinito per la voce flags se viene omesso.

Se la chiave di immissione precedente specificata è presente nei file INI, sostituire key=value con la nuova voce specificata. Solo le chiavi nei file INI devono corrispondere. Il valore corrispondente di ogni chiave di questo tipo viene ignorato.

Per aggiungere una nuova voce al file INI di destinazione in modo incondizionato, omettere il valore old-ini-entry dalla voce nella sezione update-ini dell'INF.

Per eliminare una voce precedente dal file INI di destinazione in modo incondizionato, omettere il valore new-ini-entry .
1 Se nei file INI è presente l'elemento precedente specificato (key=value), sostituirlo nel file INI di destinazione con il nuovo ini-entry specificato. Sia la chiave che il valore della voce precedente specificata devono corrispondere a quelli nei file INI per eseguire tale sostituzione, non solo le relative chiavi come per il valore dei flag precedenti.
2 Se non è possibile trovare la chiave specificata per la voce precedente nel file INI di destinazione, non eseguire alcuna operazione. In caso contrario, le modifiche apportate dipendono dalle corrispondenze trovate nei file INI per le chiavi indicate di immissione precedente e new-ini-entry, come indicato di seguito:

(1) Se la chiave della voce precedente è presente nei file INI, ma in questo caso la chiave della nuova voce ini, sostituire la voce precedente con la voce new-ini con il nuovo ini-entry nel file INI di destinazione e quindi rimuovere il superfluo new-ini-entry da tale file INI.

(2) Se la chiave della voce precedente è presente nei file INI, ma la chiave della nuova voce non viene sostituita, sostituire la chiave di immissione precedente con quella della nuova voce ini nel file INI di destinazione, ma lasciare invariato il valore della voce precedente.
3 Se non è possibile trovare la chiave e il valore specificati per la voce precedente nei file INI, non eseguire alcuna operazione. In caso contrario, le modifiche apportate dipendono dalle corrispondenze trovate nei file INI per le chiavi e i valori specificati di old-ini-entry e new-ini-entry, come indicato di seguito:

(1) Se il valore key=value della voce precedente è presente nei file INI, ma in questo caso il valore key=della nuova voce ini, sostituire la voce ini precedente con la voce new-ini-entry nel file INI di destinazione e quindi rimuovere il superfluo new-ini-entry da tale file INI.

(2) Se il valore key= della voce precedente è presente nei file INI, ma il nuovo ini-entry non lo sostituisce, sostituire l'elemento old-ini-entry con il nuovo ini-entry nel file INI di destinazione ma lasciare invariato il valore della voce precedente.

Osservazioni:

Un determinato nome di sezione update-ini 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 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.

Qualsiasi nome file specificato all'interno di una voce precedente o new-ini-entry deve designare la directory di destinazione che contiene tale file. Tale percorso di directory di destinazione di un nome file in una voce update-ini-section deve essere specificato come dirid. Per gli elenchi di possibili valori dirid , vedere Uso di Dirids.

Vedi anche

AddInterface

ClassInstall32

DDInstall

DestinationDirs

Ini2Reg

InterfaceInstall32

ProfileItems

SourceDisksFiles

SourceDisksNames

Stringhe

UpdateIniFields

Versione