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

另請參閱

ITraceDataProvider

ITraceDataProvider：：KeywordsAny