Compartilhar via

estrutura PROPERTY_DATA_DESCRIPTOR (tdh.h)

Define a propriedade a ser recuperada.

Sintaxe

typedef struct _PROPERTY_DATA_DESCRIPTOR {
  ULONGLONG PropertyName;
  ULONG     ArrayIndex;
  ULONG     Reserved;
} PROPERTY_DATA_DESCRIPTOR;

Membros

PropertyName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome da propriedade que diferencia maiúsculas de minúsculas. Você pode usar o membro NameOffset da estrutura EVENT_PROPERTY_INFO para obter o nome da propriedade.

A tabela a seguir lista os valores possíveis de PropertyName para eventos WPP. Use o tipo de dados TDH sugerido ao formatar o buffer retornado de TdhGetProperty.

Nome Tipo de dados TDH Descrição
Formattedstring TDH_INTYPE_UNICODESTRING A mensagem de rastreamento WPP formatada.
SequenceNum TDH_INTYPE_UINT32 O número de sequência local ou global da mensagem de rastreamento. Os números de sequência local, que são exclusivos apenas para esta sessão de rastreamento, são o padrão.
FunctionName TDH_INTYPE_UNICODESTRING O nome da função que gerou a mensagem de rastreamento.
ComponentName TDH_INTYPE_UNICODESTRING O nome do componente do provedor que gerou a mensagem de rastreamento. O nome do componente só será exibido se for especificado no código de rastreamento.
SubComponentName TDH_INTYPE_UNICODESTRING O nome do subcomponente do provedor que gerou a mensagem de rastreamento. O nome do subcomponente será exibido somente se for especificado no código de rastreamento.
TraceGuid TDH_INTYPE_GUID O GUID associado à mensagem de rastreamento do WPP.
GuidTypeName TDH_INTYPE_UNICODESTRING O nome do arquivo concatenado com o número de linha do código-fonte do qual a mensagem de rastreamento do WPP foi rastreada.
SystemTime TDH_INTYPE_SYSTEMTIME A hora em que a mensagem de rastreamento do WPP foi gerada.
FlagsName TDH_INTYPE_UNICODESTRING Os nomes dos sinalizadores de rastreamento que habilitam a mensagem de rastreamento.
LevelName TDH_INTYPE_UNICODESTRING O valor do nível de rastreamento que habilita a mensagem de rastreamento.

ArrayIndex

Índice baseado em zero para acessar elementos de uma matriz de propriedades. Se os dados da propriedade não forem uma matriz ou se você quiser abordar toda a matriz, especifique ULONG_MAX (0xFFFFFFFF).

Reserved

Reservado.

Comentários

Para descrever uma estrutura, defina PropertyName como o nome da estrutura e ArrayIndex como ULONG_MAX.

Para descrever um membro de uma estrutura, defina uma matriz de duas estruturas PROPERTY_DATA_DESCRIPTOR . No primeiro descritor, defina PropertyName como o nome da estrutura e ArrayIndex como 0. No segundo descritor, defina PropertyName como o nome do membro e ArrayIndex como ULONG_MAX.

Se a estrutura for um elemento de uma matriz de estruturas, defina ArrayIndex no primeiro descritor como o índice baseado em zero da estrutura na matriz.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho tdh.h

Confira também

TdhGetProperty

TdhGetPropertySize

  • Last updated on