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。 否则,除了其他返回代码之外,此函数还返回以下返回代码之一。

返回代码 说明
ERROR_NOT_FOUND
未找到指定的属性。
ERROR_INSUFFICIENT_BUFFER
BufferSize 太小。 若要获取所需的缓冲区大小,请调用 TdhGetPropertySize
ERROR_INVALID_PARAMETER
一个或多个参数无效。

注解

若要在不指定属性名称的情况下检索特定属性而不是解码的事件消息,请调用 TdhGetWppProperty

要求

要求
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 tdh.h
Library Tdh.lib
DLL Tdh.dll

另请参阅

EVENT_RECORD

EventRecordCallback

TdhGetPropertySize

TdhGetWppProperty