PROPERTY_DATA_DESCRIPTOR estructura (tdh.h)
Define la propiedad que se va a recuperar.
Sintaxis
typedef struct _PROPERTY_DATA_DESCRIPTOR {
ULONGLONG PropertyName;
ULONG ArrayIndex;
ULONG Reserved;
} PROPERTY_DATA_DESCRIPTOR;
Miembros
PropertyName
Puntero a una cadena Unicode terminada en null que contiene el nombre de propiedad que distingue mayúsculas de minúsculas. Puede usar el miembro NameOffset de la estructura EVENT_PROPERTY_INFO para obtener el nombre de la propiedad.
En la tabla siguiente se enumeran los valores posibles de PropertyName para eventos de WPP. Use el tipo de datos TDH sugerido al dar formato al búfer devuelto de TdhGetProperty.
| Nombre | Tipo de datos TDH | Descripción |
|---|---|---|
| FormattedString | TDH_INTYPE_UNICODESTRING | Mensaje de seguimiento de WPP con formato. |
| SequenceNum | TDH_INTYPE_UINT32 | Número de secuencia local o global del mensaje de seguimiento. Los números de secuencia local, que son únicos solo para esta sesión de seguimiento, son los predeterminados. |
| FunctionName | TDH_INTYPE_UNICODESTRING | Nombre de la función que generó el mensaje de seguimiento. |
| ComponentName | TDH_INTYPE_UNICODESTRING | Nombre del componente del proveedor que generó el mensaje de seguimiento. El nombre del componente solo aparece si se especifica en el código de seguimiento. |
| SubComponentName | TDH_INTYPE_UNICODESTRING | Nombre del subcomponente del proveedor que generó el mensaje de seguimiento. El nombre del subcomponente solo aparece si se especifica en el código de seguimiento. |
| TraceGuid | TDH_INTYPE_GUID | GUID asociado al mensaje de seguimiento de WPP. |
| GuidTypeName | TDH_INTYPE_UNICODESTRING | El nombre de archivo concatenado con el número de línea del código fuente desde el que se realizó el seguimiento del mensaje de seguimiento de WPP. |
| SystemTime | TDH_INTYPE_SYSTEMTIME | Hora a la que se generó el mensaje de seguimiento de WPP. |
| FlagsName | TDH_INTYPE_UNICODESTRING | Nombres de las marcas de seguimiento que habilitan el mensaje de seguimiento. |
| LevelName | TDH_INTYPE_UNICODESTRING | Valor del nivel de seguimiento que habilita el mensaje de seguimiento. |
ArrayIndex
Índice de base cero para tener acceso a elementos de una matriz de propiedades. Si los datos de propiedad no son una matriz o si desea abordar toda la matriz, especifique ULONG_MAX (0xFFFFFFFF).
Reserved
Reservado.
Comentarios
Para describir una estructura, establezca PropertyName en el nombre de la estructura y ArrayIndex en ULONG_MAX.
Para describir un miembro de una estructura, defina una matriz de dos estructuras PROPERTY_DATA_DESCRIPTOR . En el primer descriptor, establezca PropertyName en el nombre de la estructura y ArrayIndex en 0. En el segundo descriptor, establezca PropertyName en el nombre del miembro y ArrayIndex en ULONG_MAX.
Si la estructura es un elemento de una matriz de estructuras, establezca ArrayIndex en el primer descriptor en el índice de base cero de la estructura de la matriz.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado | tdh.h |