Partilhar via


Quais são as cadeias de caracteres de especificação de formato estendido WPP

O WPP inclui cadeias de caracteres de especificação de formato predefinido que você pode usar em mensagens de rastreamento, além das cadeias de caracteres de formato padrão definidas para printf.

Você pode usar o %! FLAGS!, %! FUNC! e %! NÍVEL! cadeias de caracteres em um prefixo de mensagem de rastreamento e em qualquer função de rastreamento ou macro, como DoTraceMessage.

Você pode usar as outras cadeias de caracteres estendidas em qualquer função de rastreamento.

Opções de configuração padrão para tracewpp

O WPP usa "defaultwpp.ini" para as definições de configuração padrão. Esse arquivo INI padrão é incluído como parte do SDK do Windows no diretório WppConfig Rev1. Consulte esse arquivo INI para obter as informações mais recentes sobre o comportamento padrão do WPP, bem como para obter informações adicionais sobre personalização.

Rastreamento de software

Cadeia de formato Descrição
%! ARQUIVO! Exibe o nome do arquivo de origem do qual a mensagem de rastreamento foi gerada. Essa variável também pode ser usada no prefixo da mensagem de rastreamento.
%! SINALIZADORES! Exibe o valor dos sinalizadores de rastreamento que habilitam a mensagem de rastreamento. Essa variável também pode ser usada no prefixo da mensagem de rastreamento.
%! FUNC! Exibe a função que gerou a mensagem de rastreamento. Essa variável também pode ser usada no prefixo da mensagem de rastreamento.
%! NÍVEL! Exibe o nome do nível de rastreamento que habilita a mensagem de rastreamento. Essa variável também pode ser usada no prefixo da mensagem de rastreamento.
%! LINHA! Exibe o número de linha da linha no código que gerou o prefixo de rastreamento. Essa variável também pode ser usada no prefixo da mensagem de rastreamento.

Uso em geral

Cadeia de formato Descrição
%!bool! Exibe TRUE ou FALSE
%!irql! Exibe o nome do IRQL atual.
%!sid! Representa um ponteiro para o pSID (Identificador de Segurança). Exibe o SID.
GUIDs
%! GUID! Representa um ponteiro para um GUID (pGUID). Exibe o GUID apontado.
%! CLSID! ID da classe. Representa um ponteiro para um GUID de ID de classe. Exibe a cadeia de caracteres associada ao GUID. O WPP localiza a cadeia de caracteres no registro quando formata as mensagens de rastreamento.
%! LIBID! Biblioteca de tipos. Representa o GUID de uma biblioteca de tipos COM. Exibe a cadeia de caracteres associada ao GUID. O WPP localiza a cadeia de caracteres no registro quando formata as mensagens de rastreamento.
%! IID! ID da interface. Representa um ponteiro para um GUID de ID de interface. Exibe a cadeia de caracteres associada ao GUID. O WPP localiza a cadeia de caracteres no registro quando formata as mensagens de rastreamento.
Hora
%!delta! Exibe a diferença entre dois valores de tempo, em milissegundos. É um valor LONGLONG exibido no formato day~h:m:s .
%! TEMPO DE ESPERA! Exibe o tempo gasto aguardando a conclusão de algo, em milissegundos. É um valor LONGLONG exibido no formato day~h:m:s . Projetado para ser usado com %!due!.
%!devido! Exibe a hora em que algo deve ser concluído, em milissegundos. É um valor LONGLONG exibido no formato day~h:m:s . Projetado para ser usado com %! WAITTIME!.
%! TIMESTAMP!
%!datetime!
%! TEMPO!
Exibe o valor da hora do sistema em um momento específico. Esses são valores LONGLONG (SINT64) exibidos no formato SYSTEMTIME.
Você pode usar essas variáveis para representar valores de tempo diferentes em seu programa e para distinguir entre elas.

Códigos de retorno

Cadeia de formato Descrição
%! STATUS! Representa um valor status e exibe a cadeia de caracteres associada ao código status.
%! WINERROR! Representa um código de erro do Windows e exibe a cadeia de caracteres associada ao erro.
%! HRESULT! Representa um erro ou aviso e exibe o código no formato HRESULT.

Rede

Cadeia de formato Descrição
%! IPADDR! Representa um ponteiro para um endereço IP. Exibe o endereço IP.
%! PORTA! Exibe um número de porta.