Partilhar via


Habilitando categorias de eventos para um log de texto

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

A tabela a seguir lista as categorias de eventos suportadas por 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 categoria de evento Valor da categoria do evento

Instalação do dispositivo

TXTLOG_DEVINST

0x00000001

Gerenciar arquivos INF

TXTLOG_INF

0x00000002

Gerenciar filas de arquivos

TXTLOG_FILEQ

0x00000004

Copiar ficheiros

TXTLOG_COPYFILES

0x00000008

Gerenciar configurações do Registro

TXTLOG_REGISTRY

0x00000010

Verificar assinaturas digitais

TXTLOG_SIGVERIF

0x00000020

Gerir 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 gestor de dispositivos

TXTLOG_NEWDEV

0x01000000

Gerenciador PnP de modo de usuário

TXTLOG_UMPNPMGR

0x02000000

Gerenciar o repositório de drivers

TXTLOG_DRIVER_STORE

0x04000000

Operação do instalador de classe ou coinstalador

TXTLOG_INSTALLER

0x40000000

Operação fornecida pelo fornecedor

TXTLOG_VENDOR

0x80000000

Para habilitar categorias de eventos para os logs da API Setup, crie (ou modifique) o seguinte valor REG_DWORD 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 registo LogMask não existir, o SetupAPI habilitará todas as categorias de eventos para os logs de texto. Se o valor do Registro LogMask for zero, SetupAPI desabilitará todas as categorias de eventos para os logs de texto.

O valor do Registro LogMask é formatado como 0XVVVVVVVVV, onde 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 apenas entradas de log gravadas por operações de instalação do dispositivo, defina LogMask com 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).