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 |