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 da 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 aos quais a SetupAPI dá suporte 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 alto.
| Nível do evento | Constante de manifesto no nível do evento | Valor do manifesto no nível do evento |
|---|---|---|
Somente erros de gravação. |
TXTLOG_ERROR |
1 |
Escrever erros e avisos de possíveis problemas. |
TXTLOG_WARNING |
2 |
Erros de gravação, avisos e alterações de estado do sistema. |
TXTLOG_SYSTEM_STATE_CHANGE |
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 |
Erros de gravação, 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 |
Erros de gravação, 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_VERY_VERBOSE |
7 |
Para definir o nível de evento para os logs de texto SetupAPI, crie (ou modifique) o seguinte REG_DWORD valor do Registro:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\LogLevel
Se o valor do Registro LogLevel não existir ou tiver um valor igual a zero, SetupAPI definirá o nível de evento para os logs de texto de instalação do aplicativo e da instalação do dispositivo para os valores padrão descritos na tabela a seguir:
| Log 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 |
Log de texto de instalação do dispositivo (SetupAPI.dev.log) |
TXTLOG_DETAILS |
TXTLOG_DETAILS |
TXTLOG_DETAILS |
Para obter mais informações sobre esses arquivos de log de texto, consulte SetupAPI Text Logs.
O valor do registro LogLevel é formatado como 0xUUUUGHVW, em que:
Os oito bits de baixa ordem, representados pela máscara 0x000000VW, especificam se o registro em log está ativado para o log de instalação do aplicativo e especifica o nível de evento para o log do aplicativo.
Os próximos oito bits mais altos, representados pela máscara 0x0000GH00, especificam se o registro em log está ativado para o log de texto de instalação do dispositivo e especifica 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 registro em log do log de instalação do aplicativo, conforme mostrado na tabela a seguir.
| Valor 0xVW | Descrição |
|---|---|
Zero (padrão) |
O registro em log está ativado e o nível de evento é definido como o valor padrão, conforme descrito anteriormente. |
0x01 por meio de 0x0F |
Desativa o registro em log. |
0x10 por meio de 0x7F |
Ativa o log e define o nível de evento como 0xV. |
O valor dos bits 0xGH controla o registro em log do log de texto de instalação do dispositivo, conforme mostrado na tabela a seguir.
| Valor 0xGH | Descrição |
|---|---|
Zero (padrão) |
O registro em log está ativado e o nível de evento é definido como o valor padrão, conforme descrito anteriormente. |
0x01 por meio de 0x0F |
Desativa o registro em log. |
0x10 por meio de 0x7F |
Ativa o log e define o nível de 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 log do log de instalação do aplicativo e o log de instalação do dispositivo. Define o nível de log como os valores padrão para ambos os logs. |
0x00000101 |
Desativa o log para o log de instalação do aplicativo e o log de instalação do dispositivo. |
0x00001010 |
Ativa o log 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 log 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 log 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 log 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 log para o log de instalação do aplicativo e o log de instalação do dispositivo. Define o nível de log como TXTLOG_VERY_VERBOSE para ambos os logs. |