Compartilhar via

Habilitando categorias de evento para um log de texto

  • Artigo

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

A tabela a seguir lista as categorias de evento compatíveis com SetupAPI, as constantes de manifesto que representam as categorias de evento e os valores das constantes de manifesto.

Operação de categoria de evento Constante de manifesto da categoria de evento Valor da categoria de evento

Instalação do dispositivo

TXTLOG_DEVINST

0x00000001

Gerenciar arquivos INF

TXTLOG_INF

0x00000002

Gerenciar filas de arquivos

TXTLOG_FILEQ

0x00000004

Copiar arquivos

TXTLOG_COPYFILES

0x00000008

Gerenciar configurações do registro

TXTLOG_REGISTRY

0x00000010

Verificar assinaturas digitais

TXTLOG_SIGVERIF

0x00000020

Gerenciar propriedades de dispositivo e driver

TXTLOG_PROPERTIES

0x00000040

Dados de backup

TXTLOG_BACKUP

0x00000080

Gerenciar caixas de diálogo da interface do usuário

TXTLOG_UI

0x00000100

Novo gerenciador de dispositivos

TXTLOG_NEWDEV

0x01000000

Gerenciador de PnP no modo de usuário

TXTLOG_UMPNPMGR

0x02000000

Gerenciar o repositório de driver

TXTLOG_DRIVER_STORE

0x04000000

Instalador de classe ou operação de co-instalador

TXTLOG_INSTALLER

0x40000000

Operação fornecida pelo fornecedor

TXTLOG_VENDOR

0x80000000

Para habilitar categorias de eventos para os logs de SetupAPI, crie (ou modifique) o seguinte REG_DWORD valor do Registro:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\LogMask

O valor do registro LogMask se aplica ao log de texto de instalação do dispositivo e ao log de texto de instalação do aplicativo.

Se o valor do registro LogMask não existir, SetupAPI habilitará todas as categorias de evento para os logs de texto. Se o valor do Registro logMask for zero, SetupAPI desabilita todas as categorias de evento para os logs de texto.

O valor do registro LogMask é formatado como 0XVVVVVV, em que VVVVVVVV é um campo de 32 bits. Para habilitar todas as categorias, defina LogMask como 0XFFFFFFFF. Para habilitar apenas categorias específicas, execute um OR bit a bit das constantes de categoria de evento correspondentes. Por exemplo:

  • Para habilitar somente entradas de log gravadas por operações de instalação do dispositivo, defina LogMask como o valor de TXTLOG_DEVINST (0X00000001)

  • Para habilitar somente entradas de log gravadas por operações de instalação de dispositivo e operações de armazenamento de driver, defina LogMask como (TTXTLOG_DRIVER_STORE | TEXTLOG_DEVINST) (0x04000001).

  • Para habilitar somente entradas de log gravadas por operações de instalação personalizadas, defina LogMask como TXTLOG_VENDOR (0x80000000).