struktur PROPERTY_DATA_DESCRIPTOR (tdh.h)

Menentukan properti yang akan diambil.

Sintaks

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

Anggota

PropertyName

Penunjuk ke string Unicode yang dihentikan null yang berisi nama properti peka huruf besar/kecil. Anda dapat menggunakan anggota NameOffset dari struktur EVENT_PROPERTY_INFO untuk mendapatkan nama properti.

Tabel berikut ini mencantumkan kemungkinan nilai PropertyName untuk peristiwa WPP. Gunakan tipe data TDH yang disarankan saat memformat buffer yang dikembalikan dari TdhGetProperty.

Nama	Tipe Data TDH	Deskripsi
FormattedString	TDH_INTYPE_UNICODESTRING	Pesan jejak WPP yang diformat.
SequenceNum	TDH_INTYPE_UINT32	Nomor urutan lokal atau global dari pesan pelacakan. Nomor urutan lokal, yang hanya unik untuk sesi pelacakan ini, adalah default.
FunctionName	TDH_INTYPE_UNICODESTRING	Nama fungsi yang menghasilkan pesan pelacakan.
ComponentName	TDH_INTYPE_UNICODESTRING	Nama komponen penyedia yang menghasilkan pesan pelacakan. Nama komponen hanya muncul jika ditentukan dalam kode pelacakan.
SubComponentName	TDH_INTYPE_UNICODESTRING	Nama subkomponen penyedia yang menghasilkan pesan pelacakan. Nama subkomponen hanya muncul jika ditentukan dalam kode pelacakan.
TraceGuid	TDH_INTYPE_GUID	GUID yang terkait dengan pesan jejak WPP.
GuidTypeName	TDH_INTYPE_UNICODESTRING	Nama file digabungkan dengan nomor baris dari kode sumber tempat pesan jejak WPP dilacak.
SystemTime	TDH_INTYPE_SYSTEMTIME	Waktu ketika pesan jejak WPP dibuat.
FlagsName	TDH_INTYPE_UNICODESTRING	Nama bendera pelacakan yang mengaktifkan pesan pelacakan.
LevelName	TDH_INTYPE_UNICODESTRING	Nilai tingkat pelacakan yang mengaktifkan pesan pelacakan.

ArrayIndex

Indeks berbasis nol untuk mengakses elemen array properti. Jika data properti bukan array atau jika Anda ingin mengatasi seluruh array, tentukan ULONG_MAX (0xFFFFFFFF).

Reserved

Dicadangkan.

Keterangan

Untuk menjelaskan struktur, atur PropertyName ke nama struktur dan ArrayIndex ke ULONG_MAX.

Untuk menjelaskan anggota struktur, tentukan array dua struktur PROPERTY_DATA_DESCRIPTOR . Di deskriptor pertama, atur PropertyName ke nama struktur dan ArrayIndex ke 0. Di deskriptor kedua, atur PropertyName ke nama anggota dan ArrayIndex ke ULONG_MAX.

Jika struktur adalah elemen dari array struktur, atur ArrayIndex di deskriptor pertama ke indeks struktur berbasis nol dalam array.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	tdh.h

Lihat juga

TdhGetProperty

TdhGetPropertySize