TdhGetWppMessage 函式 (tdh.h)

  • 發行項

擷取內嵌至 EVENT_RECORD 結構的格式化 WPP 訊息。

語法

TDHSTATUS TdhGetWppMessage(
  [in]      TDH_HANDLE    Handle,
  [in]      PEVENT_RECORD EventRecord,
  [in, out] PULONG        BufferSize,
  [out]     PBYTE         Buffer
);

參數

[in] Handle

類型： TDH_HANDLE

有效的譯碼句柄。

[in] EventRecord

類型： PEVENT_RECORD

傳遞至 EventRecordCallback 回呼的事件 記錄。

[in, out] BufferSize

類型： PULONG

Buffer 參數的大小，以位元組為單位。

[out] Buffer

類型： PBYTE

接收屬性數據的使用者配置緩衝區。

傳回值

類型： ULONG

如果成功，則傳回ERROR_SUCCESS。 否則，此函式除了傳回其他傳回碼之外，還會傳回下列其中一個傳回碼。

傳回碼 Description
ERROR_NOT_FOUND
 找不到指定的屬性。
ERROR_INSUFFICIENT_BUFFER
 BufferSize 太小。 若要取得所需的緩衝區大小，請呼叫 TdhGetPropertySize。
ERROR_INVALID_PARAMETER
 一或多個參數無效。

備註

若要在不指定屬性名稱的情況下擷取特定屬性，而不是譯碼的事件訊息，請呼叫 TdhGetWppProperty。

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 tdh.h
程式庫 Tdh.lib
Dll Tdh.dll

另請參閱

EVENT_RECORD

EventRecordCallback

TdhGetPropertySize

TdhGetWppProperty