Diretiva INF DelReg

Artigo
06/15/2023

Cuidado

Se você estiver criando um pacote universal ou do Driver do Windows, essa diretiva não será válida. Consulte Usando um arquivo INF universal e Introdução com drivers do Windows.

Uma diretiva DelReg faz referência a uma ou mais seções definidas pelo gravador INF que descrevem as entradas de chave e/ou valor a serem removidas do Registro.

[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)
 
DelReg=del-registry-section[,del-registry-section]...

Cada del-registry-section referenciada por uma diretiva DelReg tem o seguinte formato:

[del-registry-section]
reg-root-string,subkey[,value-entry-name][,flags][,value]
reg-root-string,subkey[,value-entry-name][,flags][,value]
...

Uma del-registry-section pode ter qualquer número de entradas, cada uma em uma linha separada.

Entradas

reg-root-string
Identifica a raiz da árvore do Registro para outros valores fornecidos nesta entrada. O valor pode ser um dos seguintes:

HKCR
Abreviação para HKEY_CLASSES_ROOT.

HKCU
Abreviação para HKEY_CURRENT_USER.

HKLM
Abreviação para HKEY_LOCAL_MACHINE.

HKU
Abreviação para HKEY_USERS.

HKR
Raiz relativa, na qual as chaves especificadas usando essa abreviação são relativas à chave do Registro associada à seção INF na qual essa diretiva DelReg aparece, conforme indicado na tabela a seguir.

Seção INF que contém a diretiva AddReg	Chave do Registro referenciada por HKR
Seção INF DDInstall	A chave de software do dispositivo
INF DDInstall. Seção HW	A chave de hardware do dispositivo
INF DDInstall. Seção Serviços	A chave serviços

Observação

O HKR não pode ser usado em uma seção del-registry referenciada de uma seção INF DefaultInstall.

Para obter mais informações sobre informações de driver armazenadas na raiz HKEY_LOCAL_MACHINE , consulte Árvores e chaves do Registro para dispositivos e drivers.

subkey
Esse valor opcional, formado como um token %strkey% definido em uma seção Strings do INF ou como um caminho do Registro sob o reg-root fornecido (key1\key2\key3...), especifica um dos seguintes:

Uma subchave a ser excluída do registro no final do caminho do Registro fornecido
Uma subchave existente da qual o valor-entry-name deve ser excluído

value-entry-name
Esse valor identifica uma entrada de valor nomeado a ser removida da subchave fornecida. Esse valor e sua vírgula anterior devem ser omitidos se a subchave em si estiver sendo removida do registro.

sinalizadores (Windows XP e versões posteriores do Windows.)
Esse valor hexadecimal opcional, expresso como uma máscara de bits ORed de valores de sinalizador de palavra baixa e palavra alta definidos pelo sistema, define o tipo de dados para uma entrada de valor ou controla a operação delete-registry. Se flags não for especificado, a subchave value-entry-name (se especificada) ou será excluída.

Os valores de máscara de bits para cada um desses sinalizadores são os seguintes:

0x00002000 (FLG_DELREG_KEYONLY_COMMON)
Exclua a subchave inteira.

0x00004000 (FLG_DELREG_32BITKEY)
Faça a alteração especificada no registro de 32 bits. Se não for especificado, a alteração será feita no registro nativo.

0x00018002 (FLG_DELREG_MULTI_SZ_DELSTRING)
Em uma entrada de registro de várias cadeias de caracteres, exclua todas as cadeias de caracteres que correspondam a um valor de cadeia de caracteres especificado por valor. A diferenciação entre maiúsculas e minúsculas é ignorada.

value (Windows XP e versões posteriores do Windows.)
Especifica um valor do Registro, se sinalizadores indicarem que um valor do Registro é necessário.

Comentários

Uma diretiva DelReg pode ser especificada em qualquer uma das seções mostradas na instrução de sintaxe formal acima. Essa diretiva também pode ser especificada em qualquer uma das seguintes seções definidas pelo gravador INF:

Uma seção service-install-section ou event-log-install referenciada pela diretiva AddService em um INF DDInstall. Seção Serviços.
Uma seção add-interface referenciada pela diretiva AddInterface em um INF DDInstall. Seção Interfaces.
Uma seção install-interface referenciada em uma seção INTERFACEInstall32 do INF.

Em geral, um INF nunca deve tentar excluir subchaves ou entradas de valor em subchaves existentes que foram configuradas por componentes do sistema ou pelos arquivos INF para outros dispositivos. A finalidade de uma del-registry-section é limpo informações obsoletas do Registro de uma instalação anterior usando um novo arquivo INF fornecido pelo mesmo provedor.

Cada nome del-registry-section deve ser exclusivo para o arquivo INF, mas pode ser referenciado por diretivas DelReg em outras seções do mesmo INF. Cada nome de seção deve seguir as regras gerais para definir nomes de seção. Para obter mais informações sobre essas regras, consulte Regras de sintaxe geral para arquivos INF.

Com versões do sistema operacional anteriores ao Windows XP, a única maneira de excluir uma chave é especificando o seguinte:

reg-root-string, subkey

Para o Windows XP e versões posteriores do Windows, o seguinte também é permitido (para especificar o registro de 32 bits):

reg-root-string, subkey,,0x4000

Exemplos

Este exemplo mostra como o INF do instalador de classe de portas COM/LPT fornecido pelo sistema remove informações de registro específicas do NT obsoletas sobre portas COM do registro.

[ComPort.NT]
AddReg=ComPort.NT.AddReg
 ... ; more directives omitted here

[ComPort.NT.HW]
DelReg=ComPort.NT.HW.DelReg

[Comport.NT.AddReg]
HKR,,EnumPropPages32,,"MSPorts.dll,SerialPortPropPageProvider"

[ComPort.NT.HW.DelReg]
HKR,,UpperFilters