Partilhar via


Definindo o nível de evento para um log de texto

SetupAPI grava uma entrada de log em um log de texto somente se o nível de evento definido para um log de texto for maior ou igual ao nível de evento para a entrada de log e a categoria de evento para a entrada de log estiver habilitada para o log de texto.

A tabela a seguir lista os níveis de evento que SetupAPI suporta e as constantes de manifesto que representam esses níveis de evento. TXTLOG_ERROR é o nível de evento mais baixo, seguido pelo próximo nível de evento mais alto TXTLOG_WARNING, e assim por diante. TXTLOG_VERY_VERBOSE é o nível de evento mais elevado.

Nível do evento Constante de manifesto no nível do evento Valor manifesto a nível de evento

Apenas escreva erros.

TXTLOG_ERROR

1

Escreva erros e avisos de possíveis problemas.

TXTLOG_WARNING

2

Registar erros, avisos e alterações de estado do sistema.

REGISTRO_DO_SISTEMA_ALTERAÇÃO_DE_ESTADO

3

Erros de gravação, avisos, alterações de estado do sistema e operações de alto nível associadas a alterações de estado.

TXTLOG_SUMMARY

4

Escreva erros, avisos, alterações de estado do sistema, operações de alto nível associadas a alterações de estado e a maioria dos detalhes operacionais.

TXTLOG_DETAILS

5

Escreva erros, avisos, alterações de estado do sistema, operações de alto nível associadas a alterações de estado e todos os detalhes operacionais.

TXTLOG_VERBOSE

6

Escreva todas as entradas de log, incluindo aquelas que podem gerar uma grande quantidade de informações que são frequentemente supérfluas.

TXTLOG_MUITO_VERBOSE

7

Para definir o nível de evento para os logs de texto SetupAPI, crie (ou modifique) o seguinte valor REG_DWORD do registo:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\LogLevel

Se o valor do Registro LogLevel não existir ou tiver um valor zero, SetupAPI definirá o nível de evento para os logs de texto de instalação do aplicativo e instalação do dispositivo para os valores padrão descritos na tabela a seguir:

Registo de texto Valor padrão (Windows 7 e versões posteriores) Valor padrão (Windows Vista SP2) Valor padrão (Windows Vista SP1 e versões anteriores)

Log de texto de instalação do aplicativo (SetupAPI.app.log)

TXTLOG_SUMMARY

TXTLOG_WARNING

TXTLOG_DETAILS

Registo de texto de instalação do dispositivo (SetupAPI.dev.log)

TXTLOG_DETAILS

TXTLOG_DETAILS

Detalhes do Registo de Texto

Para obter mais informações sobre esses arquivos de log de texto, consulte SetupAPI Text Logs.

O valor do Registro LogLevel é formatado como 0xUUUUGHVW, onde:

  • Os oito bits de menor ordem, representados pela máscara 0x000000VW, especificam se o registo está ativado para o registo de instalação da aplicação e especificam o nível de evento para o registo da aplicação.

  • Os próximos oito bits mais altos, representados pela máscara 0x0000GH00, especificam se o log está ativado para o log de texto de instalação do dispositivo e especificam o nível de evento para o log de texto de instalação do dispositivo.

  • Os bits de nível mais alto, representados pela máscara 0xUUUU0000, não são usados.

O valor dos bits 0xVW controla o registo da instalação do aplicativo, como mostrado na tabela seguinte.

0xVW valor Descrição

Zero (padrão)

O registro em log é ativado e o nível do evento é definido como o valor padrão, conforme descrito anteriormente.

0x01 até 0x0F

Desativa o registo.

de 0x10 a 0x7F

Ativa o logon e define o nível do evento como 0xV.

O valor dos bits 0xGH controla o registo do log de texto de instalação do dispositivo, conforme mostrado na tabela a seguir.

0xGH valor Descrição

Zero (padrão)

O registro em log é ativado e o nível do evento é definido como o valor padrão, conforme descrito anteriormente.

de 0x01 a 0x0F

Desativa o registo de logs.

0x10 a 0x7F

Ativa o logon e define o nível do evento como 0xG.

A tabela a seguir fornece exemplos de valores típicos de LogLevel.

Valor LogLevel Níveis de evento definidos para os logs de texto

0x00000000

Por padrão, ativa o logon para o log de instalação do aplicativo e o log de instalação do dispositivo. Configura o nível de registo para os valores padrão de ambos os registos.

0x00000101

Desativa o registo para o log de instalação da aplicação e o log de instalação do dispositivo.

0x00001010

Ativa o logon para o log de instalação do aplicativo e o log de instalação do dispositivo. Define o nível de log como TXTLOG_ERROR para ambos os logs.

0x00002020

Ativa o logon para o log de instalação do aplicativo e o log de instalação do dispositivo. Define o nível de log como TXTLOG_WARNING para ambos os logs.

0x00005050

Ativa o logon para o log de instalação do aplicativo e o log de instalação do dispositivo. Define o nível de log como TXTLOG_DETAILS para ambos os logs.

0x00006060

Ativa o logon para o log de instalação do aplicativo e o log de instalação do dispositivo. Define o nível de log como TXTLOG_VERBOSE para ambos os logs.

0x00007070

Ativa o logon para o log de instalação do aplicativo e o log de instalação do dispositivo. Define o nível de registo como TXTLOG_VERY_VERBOSE para ambos os logs.