Share via

structure PROPERTY_DATA_DESCRIPTOR (tdh.h)

  • Article

Définit la propriété à récupérer.

Syntaxe

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

Membres

PropertyName

Pointeur vers une chaîne Unicode terminée par null qui contient le nom de propriété respectant la casse. Vous pouvez utiliser le membre NameOffset de la structure EVENT_PROPERTY_INFO pour obtenir le nom de la propriété.

Le tableau suivant répertorie les valeurs possibles de PropertyName pour les événements WPP. Utilisez le type de données TDH suggéré lors de la mise en forme de la mémoire tampon retournée à partir de TdhGetProperty.

Nom Type de données TDH Description
FormattedString TDH_INTYPE_UNICODESTRING Message de suivi WPP mis en forme.
SequenceNum TDH_INTYPE_UINT32 Numéro de séquence local ou global du message de trace. Les numéros de séquence locaux, qui sont uniques uniquement à cette session de trace, sont la valeur par défaut.
FunctionName TDH_INTYPE_UNICODESTRING Nom de la fonction qui a généré le message de trace.
ComponentName TDH_INTYPE_UNICODESTRING Nom du composant du fournisseur qui a généré le message de trace. Le nom du composant apparaît uniquement s’il est spécifié dans le code de suivi.
SubComponentName TDH_INTYPE_UNICODESTRING Nom du sous-composant du fournisseur qui a généré le message de trace. Le nom du sous-composant apparaît uniquement s’il est spécifié dans le code de suivi.
TraceGuid TDH_INTYPE_GUID GUID associé au message de trace WPP.
GuidTypeName TDH_INTYPE_UNICODESTRING Nom de fichier concaténé avec le numéro de ligne du code source à partir duquel le message de trace WPP a été tracé.
SystemTime TDH_INTYPE_SYSTEMTIME Heure à laquelle le message de trace WPP a été généré.
FlagsName TDH_INTYPE_UNICODESTRING Noms des indicateurs de trace qui activent le message de trace.
LevelName TDH_INTYPE_UNICODESTRING Valeur du niveau de trace qui active le message de trace.

ArrayIndex

Index de base zéro pour accéder aux éléments d’un tableau de propriétés. Si les données de propriété ne sont pas un tableau ou si vous souhaitez traiter le tableau entier, spécifiez ULONG_MAX (0xFFFFFFFF).

Reserved

Réservé.

Remarques

Pour décrire une structure, définissez PropertyName sur le nom de la structure et ArrayIndex sur ULONG_MAX.

Pour décrire un membre d’une structure, définissez un tableau de deux structures PROPERTY_DATA_DESCRIPTOR . Dans le premier descripteur, définissez PropertyName sur le nom de la structure et ArrayIndex sur 0. Dans le deuxième descripteur, définissez PropertyName sur le nom du membre et ArrayIndex sur ULONG_MAX.

Si la structure est un élément d’un tableau de structures, définissez ArrayIndex dans le premier descripteur sur l’index de base zéro de la structure dans le tableau.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête tdh.h

Voir aussi

TdhGetProperty

TdhGetPropertySize