Directiva Ini2Reg de INF
Precaución
A partir de Windows 11 versión 22H2, un paquete de controladores que usa esta directiva ya no es apto para una firma del Centro para desarrolladores de hardware.
Los paquetes de controladores universales y los controladores de Windows no pueden usar esta directiva.
Una directiva Ini2Reg hace referencia a una o varias secciones con nombre en las que las líneas o secciones de un archivo INI proporcionado se mueven al registro. Esto crea o reemplaza una o varias entradas de valor en una clave especificada.
[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]...
Cada sección con nombre a la que hace referencia una directiva Ini2Reg tiene el siguiente formato:
[ini-to-registry-section]
ini-file,ini-section,[ini-key],reg-root,subkey[,flags]
...
Una ini-to-registry-section puede tener cualquier número determinado de entradas INF-writer-determined, cada una en una línea independiente.
Entries
ini-file
Especifica el nombre de un archivo INI proporcionado en el medio de origen. Este valor se puede expresar como un filename o como un token %strkey% que se define en una sección Strings del archivo INF.
ini-section
Especifica el nombre de la sección dentro del archivo INI especificado que contiene la información del registro que se va a copiar.
ini-key
Especifica el nombre de la clave del archivo INI que se va a copiar en el registro. Si se omite este valor, toda la ini-section se transferirá a la subclave del registro especificada.
reg-root
Identifica la raíz del árbol del registro para otros valores proporcionados en esta entrada. Para obtener información específica, consulte la referencia de la directiva AddReg.
subkey
Identifica la subclave que va a recibir el valor, expresada como un token %strkey% definido en una sección Strings del INF o como una ruta de acceso explícita al registro (key1\key2\key3...) de la reg-root especificada.
flags
Especifica (en bit 0) cómo controlar el archivo INI después de transferir la información indicada al registro o (en el bit 1) si se sobrescribe la información del registro existente, como se indica a continuación:
Bit cero = 0
No eliminar la información especificada del archivo INI después de copiarla en el registro. Este es el valor predeterminado.
Bit cero = 1
Eliminar la información especificada del archivo INI después de moverla al registro.
Bit uno = 0
Si la subclave especificada ya existe en el registro, no transferir la información proporcionada por el INI a esta subclave. De lo contrario, crear la subclave especificada en el registro con esta información proporcionada por el INI como entrada de valor. Este es el valor predeterminado.
Bit uno = 1
Si la subclave especificada ya existe en el registro, reemplazar su entrada de valor por la información proporcionada por el INI.
Comentarios
La directiva Ini2Reg es válida en cualquiera de las secciones que se muestran en la instrucción de sintaxis formal. Esta directiva también es válida en las secciones INF-writer-defined a las que hace referencia una directiva AddInterface o a las que se hace referencia en una sección InterfaceInstall32.
Si se usa un archivo INF para instalar dispositivos en Windows XP y versiones posteriores de Windows, el archivo INF no debe contener directivas Ini2Reg. Los archivos INF que contengan directivas Ini2Reg no pasarán la prueba del logotipo "Diseñado para Windows", no recibirán una firma digital y, por lo tanto, Windows no confiará en ellos (consulte Cómo selecciona Windows los controladores).
Cada nombre de ini-to-registry-section debe ser único para el archivo INF. Cada nombre de sección INF-writer-created debe ser único dentro del archivo INF y debe seguir las reglas generales para definir nombres de sección. Para obtener más información sobre estas reglas, consulte Reglas generales de sintaxis para archivos INF.
El INF proporciona la ruta de acceso completa del ini-file especificado en el medio de distribución de una de las maneras siguientes:
En los archivos INF proporcionados por IHV/OEM, mediante SourceDisksNames y, posiblemente, las secciones SourceDisksFiles de este INF especifican explícitamente la ruta de acceso completa de cada archivo de origen con nombre que no está en el directorio o directorios raíz en el medio de distribución.
En los archivos INF proporcionados por el sistema, proporcionando uno o varios archivos INF adicionales, identificados en la entrada LayoutFile de la sección Version del archivo INF.