Skip to main content
PROPERTY_DATA_DESCRIPTOR structure

Defines the property to retrieve.

Syntax


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

Members

PropertyName

Pointer to a null-terminated Unicode string that contains the case-sensitive property name. You can use the NameOffset member of the EVENT_PROPERTY_INFO structure to get the property name.

The following table lists the possible values of PropertyName for WPP events. Use the suggested TDH data type when formatting the returned buffer from TdhGetProperty.

NameTDH Data TypeDescription
FormattedStringTDH_INTYPE_UNICODESTRINGThe formatted WPP trace message.
SequenceNumTDH_INTYPE_UINT32The local or global sequence number of the trace message. Local sequence numbers, which are unique only to this trace session, are the default.
FunctionNameTDH_INTYPE_UNICODESTRINGThe name of the function that generated the trace message.
ComponentNameTDH_INTYPE_UNICODESTRINGThe name of the component of the provider that generated the trace message. The component name appears only if it is specified in the tracing code.
SubComponentNameTDH_INTYPE_UNICODESTRINGThe name of the subcomponent of the provider that generated the trace message. The subcomponent name appears only if it is specified in the tracing code.
TraceGuidTDH_INTYPE_GUIDThe GUID associated with the WPP trace message.
GuidTypeNameTDH_INTYPE_UNICODESTRINGThe file name concatenated with the line number from the source code from which the WPP trace message was traced.
SystemTimeTDH_INTYPE_SYSTEMTIMEThe time when the WPP trace message was generated.
FlagsNameTDH_INTYPE_UNICODESTRINGThe names of the trace flags enabling the trace message.
LevelNameTDH_INTYPE_UNICODESTRINGThe value of the trace level enabling the trace message.

 

ArrayIndex

Zero-based index for accessing elements of a property array. If the property data is not an array or if you want to address the entire array, specify ULONG_MAX (0xFFFFFFFF).

Reserved

Reserved.

Remarks

To describe a structure, set PropertyName to the name of the structure and ArrayIndex to ULONG_MAX.

To describe a member of a structure, define an array of two PROPERTY_DATA_DESCRIPTOR structures. In the first descriptor, set PropertyName to the name of the structure and ArrayIndex to 0. In the second descriptor, set PropertyName to the name of the member and ArrayIndex to ULONG_MAX.

If the structure is an element of an array of structures, set ArrayIndex in the first descriptor to the zero-based index of the structure in the array.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Tdh.h

See also

TdhGetProperty
TdhGetPropertySize