Compartilhar via


Configurando níveis de log de SetupAPI

Você pode controlar a quantidade de informações gravadas no log setupAPI, seja para todos os aplicativos de instalação do dispositivo ou para aplicativos de instalação de dispositivo individuais.

Para alterar o nível de informações gravadas no log setupAPI para todos os aplicativos de instalação do dispositivo, crie (ou modifique) o seguinte valor do Registro:

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\LogLevel

Ao definir esse valor (usando os valores listados nas tabelas abaixo), você pode escolher o nível de erros registrados, modificar a verbosidade do registro em log ou desativar o registro em log. Você também pode registrar informações em um depurador, bem como no arquivo de log.

Para especificar níveis de log para aplicativos de instalação de dispositivo individuais, crie uma entrada do Registro sob a seguinte chave:

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\AppLogLevels

Sob essa chave, crie um nome de valor que represente o nome do arquivo executável do aplicativo e atribua o nível de log desejado a esse nome (usando os valores listados nas tabelas abaixo), como service.exe=LoggingLevel.

O nível de log é um valor DWORD. Se esse valor não for especificado ou for zero, SetupAPI usará um comportamento padrão, conforme indicado nas tabelas abaixo.

O valor DWORD é composto por três partes, formatadas como 0xSSSSDDGG. Os oito bits baixos, representados pela máscara 0x000000FF, definem o nível de log para operações gerais de instalação do dispositivo. Os próximos oito bits superiores, representados pela máscara 0x0000FF00, definem o nível de registro em log para operações de instalação do dispositivo. Os bits mais altos são sinalizadores especiais.

As tabelas a seguir contêm os níveis gerais de log, os níveis de log de instalação do dispositivo e os sinalizadores de log especiais para o Windows 2000 e posterior.

Níveis gerais de registro em log Significado
0x00000000 Use configurações padrão (atualmente 0x20).
0x00000001 Desativado (sem registro em log de instalação do dispositivo).
0x00000010 Erros de log.
0x00000020 Erros e avisos de log.
0x00000030 Erros de log, avisos e outras informações.
0x00000040 Erros de log, avisos e outras informações no modo detalhado.
0x00000050 Erros de log, avisos e outras informações no modo detalhado, além de entradas com carimbo de data/hora.
0x00000060 Erros de log, avisos e outras informações no modo detalhado, além de entradas de tempo. Além disso, todas as entradas têm carimbo de data/hora.
0x00000070 Erros de log, avisos e outras informações no modo detalhado, além de mensagens de tempo. Todas as entradas têm carimbo de data/hora. Mensagens adicionais que podem retardar o sistema, como ocorrências de cache, são incluídas.
0x000000FF Especifica o log mais detalhado disponível.
Níveis de registro em log do dispositivo Significado
0x00000000 Use configurações padrão (atualmente 0x3000).
0x00000100 Desativado (sem registro em log de instalação do dispositivo).
0x00001000 Erros de log.
0x00002000 Erros e avisos de log.
0x00003000 Erros de log, avisos e outras informações.
0x00004000 Erros de log, avisos e outras informações no modo detalhado.
0x00005000 Erros de log, avisos e outras informações no modo detalhado, além de entradas com carimbo de data/hora.
0x00006000 Erros de log, avisos e outras informações no modo detalhado, além de entradas de tempo. Além disso, todas as entradas têm carimbo de data/hora.
0x00007000 Erros de log, avisos e outras informações no modo detalhado, além de mensagens de tempo. Todas as entradas têm carimbo de data/hora. Mensagens adicionais que podem retardar o sistema, como ocorrências de cache, são incluídas.
0x0000FF00 Especifica o log mais detalhado disponível.
Sinalizadores especiais Significado
0x08000000 (Windows XP e posterior) Adicione um carimbo de data/hora a todas as entradas de log.
0x20000000 (Windows XP e posterior) Não libere informações de log para o disco depois que cada entrada for gravada. (O registro em log é mais rápido, mas as informações podem ser perdidas se o sistema falhar.)
0x40000000 Gravar entradas de log cronologicamente em vez de agrupar entradas.
0x80000000 Envie a saída para o depurador, bem como para o arquivo de log.

Por exemplo, SetupAPI interpreta alguns valores LoggingFlags de exemplo da seguinte maneira:

  • 0x00000000 significa registro em log padrão.

  • 0x0000FFFF significa log detalhado.

  • 0x8000FF00 significa informações detalhadas de instalação do dispositivo para o arquivo de log e o depurador.

Para modificar os níveis de log de SetupAPI padrão durante uma instalação de limpo, edite o registro durante o período entre a configuração do modo de texto e a instalação do modo GUI. As etapas a seguir descrevem o procedimento. Essas etapas pressupõem que você esteja instalando no D:\Winnt e tenha um build funcional da mesma versão do Windows em outra partição. Altere os níveis de log de SetupAPI da seguinte maneira:

  1. Inicie a instalação do limpo compilação que você está testando.

  2. Interrompa o processo de instalação durante a primeira inicialização após a configuração do modo de texto (ou seja, antes da instalação do modo GUI).

  3. Inicialize no build de trabalho selecionando-o no menu de inicialização e faça logon como Administrador.

  4. Localize os hives do registro (arquivos) em D:\Winnt\System32\config. Nesse caso, você precisa modificar o hive do Registro em Software.sav.

  5. No Windows 2000, execute Regedt32, selecione a janela "HKEY_LOCAL_MACHINE no Computador Local" e selecione a chave HKEY_LOCAL_MACHINE. Em seguida, clique no menu Registro e selecione Carregar Hive.

    No Windows XP e posterior, execute RegEdit. Realce HKEY_LOCAL_MACHINE, clique no menu Arquivo e selecione Carregar Hive.

  6. Navegue pelos arquivos e selecione D:\Winnt\System32\config\software.sav. Quando solicitado o nome da chave, insira "_sw.sav"

  7. Abra a chave _sw.sav em HKEY_LOCAL_MACHINE e realce a seguinte chave:

    HKEY_LOCAL_MACHINE_sw.sav\Microsoft\Windows\CurrentVersion\Setup
    

    No Windows 2000, clique no menu Segurança , selecione Permissões e conceda controle total ao Administrador.

    No Windows XP e posterior, clique no menu Editar , selecione Permissões e conceda controle total ao Administrador.

  8. No Windows 2000, adicione os valores necessários do Registro sob essa chave usando clicar em Editar e selecionar Adicionar Valor.

    No Windows XP e posterior, clique em Editar e selecione Novo Valor DWORD.

    Insira o valor . Por exemplo, adicione "0xFFFF" para habilitar o log detalhado completo.

  9. Selecione HKEY_LOCAL_MACHINE\_sw.sav e descarregue o hive (usando o menu Registro no Windows 2000 ou o menu Arquivo no Windows XP e posterior)The_sw.sav key deve desaparecer.

  10. Copie D:\Winnt\System32\config\software.sav para D:\Winnt\System32\config\software.

  11. Reinicialize e continue na Instalação.

  12. Para verificar essa alteração, pressione SHIFT+F10 na Instalação do modo GUI e execute regedit.exe e marcar o nível de log.