PROPERTY_DATA_DESCRIPTOR struttura (tdh.h)
Definisce la proprietà da recuperare.
Sintassi
typedef struct _PROPERTY_DATA_DESCRIPTOR {
ULONGLONG PropertyName;
ULONG ArrayIndex;
ULONG Reserved;
} PROPERTY_DATA_DESCRIPTOR;
Members
PropertyName
Puntatore a una stringa Unicode con terminazione null contenente il nome della proprietà con distinzione tra maiuscole e minuscole. È possibile usare il membro NameOffset della struttura EVENT_PROPERTY_INFO per ottenere il nome della proprietà.
Nella tabella seguente sono elencati i valori possibili di PropertyName per gli eventi WPP. Usare il tipo di dati TDH suggerito durante la formattazione del buffer restituito da TdhGetProperty.
| Nome | Tipo di dati TDH | Descrizione |
|---|---|---|
| FormattedString | TDH_INTYPE_UNICODESTRING | Messaggio di traccia WPP formattato. |
| SequenceNum | TDH_INTYPE_UINT32 | Numero di sequenza locale o globale del messaggio di traccia. I numeri di sequenza locali, univoci solo per questa sessione di traccia, sono il valore predefinito. |
| FunctionName | TDH_INTYPE_UNICODESTRING | Nome della funzione che ha generato il messaggio di traccia. |
| ComponentName | TDH_INTYPE_UNICODESTRING | Nome del componente del provider che ha generato il messaggio di traccia. Il nome del componente viene visualizzato solo se viene specificato nel codice di traccia. |
| SubComponentName | TDH_INTYPE_UNICODESTRING | Nome del sottocomponente del provider che ha generato il messaggio di traccia. Il nome del sottocomponente viene visualizzato solo se specificato nel codice di traccia. |
| TraceGuid | TDH_INTYPE_GUID | GUID associato al messaggio di traccia WPP. |
| GuidTypeName | TDH_INTYPE_UNICODESTRING | Il nome del file concatenato con il numero di riga dal codice sorgente da cui è stato tracciato il messaggio di traccia di traccia WPP. |
| SystemTime | TDH_INTYPE_SYSTEMTIME | Ora in cui è stato generato il messaggio di traccia WPP. |
| FlagsName | TDH_INTYPE_UNICODESTRING | Nomi dei flag di traccia che abilitano il messaggio di traccia. |
| LevelName | TDH_INTYPE_UNICODESTRING | Valore del livello di traccia che abilita il messaggio di traccia. |
ArrayIndex
Indice in base zero per l'accesso agli elementi di una matrice di proprietà. Se i dati della proprietà non sono una matrice o se si vuole affrontare l'intera matrice, specificare ULONG_MAX (0xFFFFFFFF).
Reserved
Riservato.
Commenti
Per descrivere una struttura, impostare PropertyName sul nome della struttura e ArrayIndex su ULONG_MAX.
Per descrivere un membro di una struttura, definire una matrice di due strutture PROPERTY_DATA_DESCRIPTOR . Nel primo descrittore impostare PropertyName sul nome della struttura e ArrayIndex su 0. Nel secondo descrittore impostare PropertyName sul nome del membro e ArrayIndex su ULONG_MAX.
Se la struttura è un elemento di una matrice di strutture, impostare ArrayIndex nel primo descrittore sull'indice in base zero della struttura nella matrice.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | tdh.h |