Compartilhar via

Gravando uma entrada de log de informações

  • Artigo

O exemplo a seguir mostra como um aplicativo normalmente pode chamar SetupWriteTextLog para gravar uma entrada de informações em um log de texto SetupAPI que não é uma mensagem de aviso ou uma mensagem de erro.

Para obter informações sobre como chamar SetupWriteTextLog para registrar uma mensagem de erro, consulte Chamando SetupWriteTextLog para registrar uma entrada de erro ou aviso.

O aplicativo chama SetupWriteTextLog, fornecendo os seguintes valores de parâmetro:

  • LogToken é definido como um valor de token de log que foi obtido chamando SetupGetThreadLogToken ou é um dos valores de token de log definidos pelo sistema descritos nos Tokens de Log.

  • A categoria é definida como TXTLOG_VENDOR, o que indica que a entrada de log é feita por um aplicativo fornecido pelo fornecedor. As categorias de evento são descritas em Habilitando categorias de evento para um log de texto.

  • Os sinalizadores são definidos como um OR bit a bit de TXTLOG_DETAILS e TXTLOG_TIMESTAMP. Neste exemplo, a profundidade do recuo não é alterada e a profundidade de recuo atual foi definida anteriormente como cinco espaços de texto monoespaço. Para obter informações sobre como alterar a profundidade do recuo, consulte Gravando entradas de log recuadas. Os níveis de evento são descritos no tópico Definindo o nível de evento para um log de texto .

  • MessageStr é definido como TEXT("Variável de interesse: = %d").

  • A lista de parâmetros separados por vírgulas fornece a variável SomeVariable, que corresponde ao campo "%d" em MessageStr.

//The LogToken value was previously returned by call to
//SetupGetThreadLogToken or one of the system-defined log token values
DWORD Category = TXTLOG_VENDOR; 
DWORD Flags = TXTLOG_DETAILS | TXTLOG_TIMESTAMP;
DWORD SomeVariable = 1;   // The variable whose value will be logged

SetupWriteTextLog(LogToken, Category, Flags, TEXT("Variable of interest: = %d"), SomeVariable);

Se a categoria de evento TXTLOG_VENDOR estiver habilitada e o nível de evento TXTLOG_DETAILS for definido para o log de texto de instalação do dispositivo, esse código criará uma entrada no log de instalação do dispositivo no formato a seguir, em que o carimbo de data/hora seria substituído por um carimbo de data/hora real.

     2005/02/13 22:06:28.109:    :  Variable of interest: Abc = 1