Partilhar via


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

O WPP inclui cadeias de caracteres de especificação de formato predefinidas que podem ser usadas em mensagens de rastreamento, além das cadeias de caracteres de formato padrão definidas para printf.

Você pode usar as strings %!BANDEIRAS!, %!FUNC! e %!NÍVEL! num prefixo de mensagem de rastreamento , e em qualquer função ou macro de rastreamento, 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

WPP usa "defaultwpp.ini" para as definições de configuração padrão. Esse arquivo INI padrão está incluído como parte do SDK do Windows no diretório WppConfig Rev1. Consulte este 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.

Rastreio de software

Formatar cadeia de caracteres Descrição
%! ARQUIVO! Exibe o nome do arquivo de origem a partir do qual a mensagem de rastreamento foi gerada. Essa variável também pode ser usada no prefixo da mensagem de rastreamento .
%! BANDEIRAS! 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 do que habilita a mensagem de rastreio. Essa variável também pode ser usada no prefixo da mensagem de rastreamento .
%! LINHA! Exibe o número 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 geral

Formatar cadeia de caracteres Descrição
%!bool! Exibe VERDADEIRO ou FALSO
%!irql! Exibe o nome do IRQL atual.
%!sid! Representa um ponteiro para o identificador de segurança (pSID). 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 ID de classe GUID. Exibe a cadeia de caracteres associada ao GUID. 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. 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. WPP localiza a cadeia de caracteres no registro quando formata as mensagens de rastreamento.
Tempo
%!delta! Exibe a diferença entre dois valores de tempo, em milissegundos. É um valor LONGLONG que é exibido no formato dia~h:m:s.
%! TEMPO DE ESPERA! Exibe o tempo gasto aguardando que algo seja concluído, em milissegundos. É um valor LONGLONG exibido no formato dia~h:m:s. Projetado para ser usado com %!due!.
%!em falta! Exibe o tempo que se espera que algo seja concluído, em milissegundos. É um valor LONGLONG que é exibido no formato dia~h:m:s. Projetado para ser usado com %!TEMPO DE ESPERA!.
%! CARIMBO DE DATA/HORA!
%!datetime!
%! HORA !
Exibe o valor da hora do sistema em um determinado momento. Estes são valores LONGLONG (SINT64) que são exibidos no formato SYSTEMTIME.
Você pode usar essas variáveis para representar diferentes valores de tempo em seu programa e para distinguir entre eles.

Códigos de devolução

Formatar cadeia de caracteres Descrição
%! STATUS! Representa um valor de status e exibe a cadeia de caracteres associada ao código de 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

Formatar cadeia de caracteres Descrição
%! IPADDR! Representa um ponteiro para um endereço IP. Exibe o endereço IP.
%! PORTO! Exibe um número de porta.