structure PROPERTY_DATA_DESCRIPTOR (tdh.h)
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 |