Metode ITraceDataProvider::get_KeywordsAny (pla.h)

Mengambil daftar kata kunci yang menentukan kategori peristiwa yang Anda inginkan untuk ditulis oleh penyedia.

Properti ini bersifat hanya baca.

Sintaks

HRESULT get_KeywordsAny(
  IValueMap **ppKeywords
);

Parameter

ppKeywords

Nilai kembali

Tidak ada

Keterangan

Kata kunci menentukan kategori peristiwa yang Anda inginkan untuk ditulis oleh penyedia. Penyedia menulis peristiwa jika salah satu bit kata kunci peristiwa cocok dengan salah satu bit yang diatur dalam masker KeywordsAny ini.

Untuk menyertakan semua peristiwa yang disediakan penyedia, atur properti ini ke nol. Untuk menyertakan hanya peristiwa tertentu, atur topeng kata kunci ini ke peristiwa tertentu tersebut. Misalnya, jika penyedia menentukan peristiwa untuk rutinitas inisialisasi dan pembersihannya (bit 0), peristiwa untuk operasi filenya (bit 1), dan peristiwa untuk operasi penghitungannya (bit 2), Anda dapat memilih untuk menyertakan hanya dua peristiwa ini dengan mengatur masker ini ke 5 (mengatur bit 0 dan 2) untuk menerima inisialisasi dan membersihkan peristiwa dan peristiwa perhitungan.

Untuk lebih membatasi kategori peristiwa yang Anda inginkan untuk ditulis penyedia, atur juga properti ITraceDataProvider::KeywordsAll .

Jika penyedia menentukan kata kunci peristiwa yang lebih kompleks (misalnya, penyedia menentukan peristiwa yang mengatur bit 0 untuk baca dan bit 1 untuk akses lokal dan peristiwa kedua yang mengatur bit 0 untuk baca dan bit 2 untuk akses jarak jauh), Anda dapat mengatur masker ini ke 1 untuk menerima semua peristiwa baca, atau Anda dapat mengatur masker ini ke 1 dan Kata KunciSemua masker ke 3 untuk menerima bacaan lokal saja.

Jika kata kunci peristiwa adalah nol, penyedia akan menulis peristiwa ke sesi, terlepas dari masker ini atau Kata KunciSemua masker.

Untuk penyedia yang ditulis pada sistem operasi sebelum Windows Vista, nilai kata kunci akan dipetakan ke bendera pengaktifan.

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::KeywordsAll