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