ITraceDataProvider::get_KeywordsAll 方法 (pla.h)
擷取關鍵詞清單,以限制您想要提供者寫入的事件類別。 除了 ITraceDataProvider::KeywordsAny 屬性所提供的限制之外。
這個屬性是唯讀的。
語法
HRESULT get_KeywordsAll(
IValueMap **ppKeywords
);
參數
ppKeywords
傳回值
無
備註
如果事件的任何關鍵詞位符合 KeywordsAny 屬性中設定的任何位,提供者就會寫入事件。 KeywordsAll 屬性中指定的關鍵詞會進一步限制您想要提供者寫入的事件類別。 如果事件的關鍵詞符合 KeywordsAny 條件,則提供者只有在 EventsAll 遮罩中的所有位都存在於事件的關鍵詞中時,才會寫入事件。 如果 KeywordsAny 為零,則不會使用 KeywordsAll 遮罩。
如需 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 |
標頭 | pla.h |
Dll | Pla.dll |