Поделиться через


Метод ITraceDataProvider::get_KeywordsAll (pla.h)

Извлекает список ключевых слов, ограничивающих категорию событий, которые требуется записать поставщику. Ограничения дополняются ограничениями, предоставляемыми свойством ITraceDataProvider::KeywordsAny .

Это свойство доступно только для чтения.

Синтаксис

HRESULT get_KeywordsAll(
  IValueMap **ppKeywords
);

Параметры

ppKeywords

Возвращаемое значение

None

Remarks

Поставщик записывает событие, если любой из ключевое слово битов события соответствует любому из битов, заданных в свойстве KeywordsAny. Ключевые слова, указанные в свойстве KeywordsAll, дополнительно ограничивают категорию событий, которые требуется записать поставщику. Если ключевое слово события соответствует условию KeywordsAny, поставщик записывает событие только в том случае, если все биты в маске KeywordsAll существуют в ключевое слово события. Маска KeywordsAll не используется, если Значение KeywordsAny равно нулю.

Дополнительные сведения о связи условий KeywordsAll и KeywordsAny см. в разделе Примечания статьи KeywordsAny.

Для получения или задания значения ключевых слов используется интерфейс IValueMap . Свойство IValueMap::Value можно использовать для получения значения ключевых слов (значения всех элементов карты в сочетании с оператором OR) или перечисления каждого элемента на карте для получения отдельных значений ключевое слово.

Аналогичным образом, при установке значения ключевых слов вызывается свойство IValueMap::Value, чтобы задать значение ключевых слов, или метод IValueMap::Add, чтобы добавить каждое отдельное значение ключевое слово.

Если вы используете IValueMap::Value для задания ключевых слов, а карта значений содержит один или несколько элементов, PLA выполняет поиск совпадающих значений в коллекции, включает их и отключает остальные. Если значение не существует в списке, PLA добавляет ключевое слово (элемент не называется).

Свойство IValueMapItem::Key содержит строковое представление ключевое слово. Свойство IValueMapItem::Value содержит значение ключевое слово. Свойство IValueMapItem::Enabled указывает, включена ли ключевое слово. Интерфейс IValueMapItem необходимо использовать только в том случае, если вы хотите присвоить ключевое слово или включить или отключить ключевые слова без добавления или удаления.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header pla.h
DLL Pla.dll

См. также раздел

ITraceDataProvider

ITraceDataProvider::KeywordsAny