Metode ITraceDataProvider::get_KeywordsAll (pla.h)

Mengambil daftar kata kunci yang membatasi kategori peristiwa yang Anda inginkan untuk ditulis oleh penyedia. Pembatasan ini selain yang disediakan oleh properti ITraceDataProvider::KeywordsAny .

Properti ini bersifat hanya baca.

Sintaks

HRESULT get_KeywordsAll(
  IValueMap **ppKeywords
);

Parameter

ppKeywords

Nilai kembali

Tidak ada

Keterangan

Penyedia menulis peristiwa jika salah satu bit kata kunci peristiwa cocok dengan salah satu bit yang diatur dalam properti KeywordsAny . Kata kunci yang ditentukan dalam properti Kata KunciSemua lebih lanjut membatasi kategori peristiwa yang Anda inginkan untuk ditulis oleh penyedia. Jika kata kunci peristiwa memenuhi kondisi KeywordsAny , penyedia akan menulis peristiwa hanya jika semua bit di Kata KunciSemua mask ada di kata kunci peristiwa. Kata KunciSemua masker tidak digunakan jika KeywordsAny adalah nol.

Untuk informasi selengkapnya tentang bagaimana kondisi Kata KunciSemua dan Kata KunciSertaan , lihat bagian Keterangan kata kunciSany.

Anda menggunakan antarmuka IValueMap untuk mengambil atau mengatur nilai kata kunci. Anda dapat menggunakan properti IValueMap::Value untuk mengambil nilai kata kunci (nilai semua item dalam peta saat dikombinasikan dengan operator OR ), atau Anda dapat menghitung setiap item dalam peta untuk mengambil nilai kata kunci individual.

Demikian juga, ketika Anda mengatur nilai kata kunci, Anda memanggil properti IValueMap::Value untuk mengatur nilai kata kunci, atau Anda dapat memanggil metode IValueMap::Add untuk menambahkan setiap nilai kata kunci individual.

Jika Anda menggunakan IValueMap::Value untuk mengatur kata kunci dan peta nilai berisi satu atau beberapa item, PLA mencari koleksi untuk nilai yang cocok dan mengaktifkannya dan menonaktifkan yang lain. Jika nilai tidak ada dalam daftar, PLA menambahkan kata kunci (item tidak diberi nama).

Properti IValueMapItem::Key berisi representasi string kata kunci. Properti IValueMapItem::Value berisi nilai kata kunci. Properti IValueMapItem::Enabled menunjukkan apakah kata kunci diaktifkan. Anda perlu menggunakan antarmuka IValueMapItem hanya ketika Anda ingin memberi nama kata kunci atau Anda ingin mengaktifkan atau menonaktifkan kata kunci tanpa harus menambahkan atau menghapusnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	pla.h
DLL	Pla.dll

Lihat juga

ITraceDataProvider

ITraceDataProvider::KeywordsAny