共用方式為


ITraceDataProvider::get_KeywordsAll 方法 (pla.h)

擷取關鍵詞清單,以限制您想要提供者寫入的事件類別。 除了 ITraceDataProvider::KeywordsAny 屬性所提供的限制之外。

這個屬性是唯讀的。

語法

HRESULT get_KeywordsAll(
  IValueMap **ppKeywords
);

參數

ppKeywords

傳回值

備註

如果事件的任何關鍵詞位符合 KeywordsAny 屬性中設定的任何位,提供者就會寫入事件。 KeywordsAll 屬性中指定的關鍵詞會進一步限制您想要提供者寫入的事件類別。 如果事件的關鍵詞符合 KeywordsAny 條件,則提供者只有在 EventsAll 遮罩中的所有位都存在於事件的關鍵詞中時,才會寫入事件。 如果 KeywordsAny 為零,則不會使用 KeywordsAll 遮罩。

如需 KeywordsAllKeywordsAny 條件關聯的詳細資訊,請參閱 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

另請參閱

ITraceDataProvider

ITraceDataProvider::KeywordsAny