TraceLoggingKeyword 宏 (traceloggingprovider.h)
TraceLogging 包裝函式宏 ，可設定事件的 關鍵詞。
語法
void TraceLoggingKeyword(
[in] eventKeyword
);
參數
[in] eventKeyword
64 位位掩碼，用來指出事件類別集合中的事件成員資格。 此值必須是編譯時間常數。
重要
ProviderId、Level 和 Keyword 是篩選事件的主要方法。 其他類型的篩選是可行的，但額外負荷較高。 一律將有意義的非零層級和關鍵詞指派給每個事件。
如需事件關鍵詞的詳細資訊 ，請參閱EVENT_DESCRIPTOR 。
傳回值
無
備註
TraceLoggingKeyword(eventKeyword) 可用來做為 TraceLoggingWrite 宏調用的參數，以設定事件的關鍵詞。 Event 關鍵詞是篩選事件的主要方法。 請一律將有意義的 (非零) 關鍵詞指派給每個事件。
如果未將 TraceLoggingKeyword 宏提供給 TraceLoggingWrite 呼叫，則事件的默認關鍵詞為 0。 如果提供多個 TraceLoggingKeyword 宏，這些值會一起或一起處理。
Microsoft 會定義關鍵詞的前 16 位 (位掩碼0xFFFF000000000000) 。 事件提供者會定義關鍵詞的低 48 位 (位掩碼0x0000FFFFFFFFFFFF) 。 例如，事件提供者可能會定義位0 (位掩碼0x1) 为 “I/O” 類別，位1 (位掩碼0x2) 为 “UI” 類別，而位2 (位掩碼0x4) 为「效能測量」類別。 在此案例中，事件可能會將其關鍵詞設定為0x5，指出事件同時位於「I/O」和「效能測量」類別中。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | traceloggingprovider.h |