Метод 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 |