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

Consulte también

TdhGetProperty

TdhGetPropertySize