Diretiva INF Ini2Reg
Cuidado
A partir do Windows 11 versão 22H2, um pacote de driver que usa essa diretiva não está mais qualificado para uma assinatura da Central do Desenvolvedor para Hardware.
Os pacotes de driver Universais e os Drivers do Windows não podem usar essa diretiva.
Uma diretiva Ini2Reg faz referência a uma ou mais seções nomeadas nas quais linhas ou seções de um arquivo INI fornecido são movidas para o Registro. Isso cria ou substitui uma ou mais entradas de valor em uma chave 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 seção nomeada referenciada por uma diretiva Ini2Reg tem o seguinte formato:
[ini-to-registry-section]
ini-file,ini-section,[ini-key],reg-root,subkey[,flags]
...
Uma ini-to-registry-section pode ter qualquer número de entradas INF-writer-determined, cada uma em uma linha separada.
Entradas
ini-file
Especifica o nome de um arquivo INI fornecido na mídia de origem. Esse valor pode ser expresso como um nome de arquivo ou como um token %strkey% definido em uma seção Strings do arquivo INF.
ini-section
Especifica o nome da seção dentro do arquivo INI fornecido que contém as informações do Registro a serem copiadas.
ini-key
Especifica o nome da chave no arquivo INI a ser copiada para o Registro. Se esse valor for omitido, toda ini-section deverá ser transferida para a subchave do Registro especificada.
reg-root
Identifica a raiz da árvore do Registro para outros valores fornecidos nesta entrada. Para obter detalhes, consulte a referência da diretiva AddReg.
subkey
Identifica a subchave para receber o valor, expresso como um token %strkey% definido em uma seção Strings do INF ou como um caminho do Registro explícito (key1\key2\key3...) da reg-root fornecida.
sinalizadores
Especifica (no bit 0) como lidar com o arquivo INI após a transferência das informações fornecidas para o Registro e/ou (no bit 1) se as informações do Registro existentes devem ser substituídas, da seguinte maneira:
Bit zero = 0
Não remova as informações fornecidas do arquivo INI depois de copiá-las para o Registro. Esse é o padrão.
Bit zero = 1
Exclua as informações fornecidas do arquivo INI depois de movê-las para o Registro.
Bit um = 0
Se a subchave especificada já existir no Registro, não transfira as informações fornecidas pelo INI para essa subchave. Caso contrário, crie a subchave especificada no Registro com essas informações fornecidas pelo INI como sua entrada de valor. Esse é o padrão.
Bit um = 1
Se a subchave especificada já existir no Registro, substitua sua entrada de valor pelas informações fornecidas pelo INI.
Comentários
A diretiva Ini2Reg é válida em qualquer uma das seções mostradas na instrução de sintaxe formal. Essa diretiva também é válida em seções definidas pelo gravador INF referenciadas por uma diretiva AddInterface ou referenciadas em uma seção InterfaceInstall32.
Se um arquivo INF for usado para instalar dispositivos no Windows XP e versões posteriores do Windows, o arquivo INF não deverá conter diretivas Ini2Reg. Os arquivos INF que contêm diretivas Ini2Reg não passarão no teste de logotipo "Projetado para Windows", não receberão uma assinatura digital e, portanto, não serão confiáveis pelo Windows (consulte Como o Windows seleciona os drivers).
Cada nome de ini-to-registry-section deve ser exclusivo para o arquivo INF. Cada nome de seção INF-writer-created deve ser exclusivo dentro do arquivo INF e deve seguir as regras gerais para definir nomes de seção. Para mais informações sobre essas regras, consulte Regras gerais de sintaxe para arquivos INF.
O INF fornece o caminho completo do ini-file na mídia de distribuição de uma das seguintes maneiras:
Em arquivos INF fornecidos por IHV/OEM, usando as seções SourceDisksNames e, possivelmente, SourceDisksFiles desse INF para especificar explicitamente o caminho completo de cada arquivo de origem nomeado que não está no diretório raiz (ou diretórios) na mídia de distribuição.
Em arquivos INF fornecidos pelo sistema, fornecendo um ou mais arquivos INF adicionais, identificados na entrada LayoutFile na seção Version do arquivo INF.