共用方式為

TraceLoggingBinary 宏 (traceloggingprovider.h)

  • 發行項

TraceLogging 包裝函式宏 ，會將具有二進位資料的欄位加入事件。

語法

void TraceLoggingBinary(
  [in]            pValue,
  [in]            cbValue,
  [in, optional]  __VA_ARGS__
);

參數

[in] pValue

要包含在事件中的資料指標。

[in] cbValue

要包含在事件中的資料大小，以位元組為單位。

[in, optional] __VA_ARGS__

欄位定義的選擇性 名稱、 描述和 標記 參數。

TraceLoggingBinary 可以使用 2、3、4 或 5 參數來指定。 如果未指定選擇性參數，則會使用預設值。 例如，TraceLoggingBinary(&x.data, sizeof(x.data)) 相當於 TraceLoggingBinary(&x.data, sizeof(x.data), "&x.data", "", 0)。

  • [in, optional] name

    要用於事件欄位的名稱。 如果提供，name 參數必須是字串常值， (不是變數) ，且不得包含任何 '\0' 字元。 如果未提供，事件功能變數名稱將會以 pValue為基礎。

  • [in, optional] description

    事件欄位值的描述。 如果提供，description 參數必須是字串常值，且將會包含在 PDB中。

  • [in, optional] tags

    編譯時間常數整數值。 值的低 28 位將會包含在欄位的中繼資料中。 此值的語意是由事件取用者所定義。 在事件處理期間，可以從 [EVENT_PROPERTY_INFO 標記 ] 欄位擷取此值。

傳回值

無

備註

TraceLoggingBinary(pValue, cbValue, ...) 可作為 TraceLoggingWrite 宏調用的參數。 每個 TraceLoggingBinary 參數都會將一個欄位新增至事件。

規格需求

   
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 traceloggingprovider.h

另請參閱

TraceLoggingWrite

TraceLogging 包裝函式宏