TdhGetManifestEventInformation 函数 (tdh.h)

  • 项目

TdhGetManifestEventInformation 函数检索有关清单中事件的元数据。

语法

TDHSTATUS TdhGetManifestEventInformation(
  [in]      LPGUID            ProviderGuid,
  [in]      PEVENT_DESCRIPTOR EventDescriptor,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] ULONG             *BufferSize
);

参数

[in] ProviderGuid

标识要检索其事件元数据的清单提供程序的 GUID。

[in] EventDescriptor

指向包含事件 ID、版本、操作代码和关键字 (keyword) 等信息的事件描述符的指针。 有关详细信息，请参阅 EVENT_DESCRIPTOR 结构

[out] Buffer

用户分配的缓冲区，用于接收有关提供程序清单中事件的元数据。 有关详细信息，请参阅 TRACE_EVENT_INFO 结构。

[in, out] BufferSize

Buffer 参数指向的缓冲区的大小（以字节为单位）。 如果函数成功，此参数将接收所用缓冲区的大小。 如果缓冲区太小，函数将返回 ERROR_INSUFFICIENT_BUFFER 并将此参数设置为所需的缓冲区大小。 如果输入时缓冲区大小为零，则缓冲区中不返回任何数据，并且此参数接收所需的缓冲区大小。

返回值

如果成功，则返回 ERROR_SUCCESS 。 否则，此函数除了返回其他返回代码外，还会返回以下返回代码之一。

返回代码 说明
ERROR_EMPTY
 清单中没有为提供程序 GUID 定义事件。
ERROR_FILE_NOT_FOUND
 找不到提供程序的元数据。
ERROR_INSUFFICIENT_BUFFER
 Buffer 参数指向的 缓冲区 大小太小。 使用 BufferSize 参数中设置的所需缓冲区大小来分配新缓冲区。
ERROR_INVALID_PARAMETER
 一个或多个参数无效。
ERROR_NOT_FOUND
 找不到提供的提供程序 GUID 的架构信息。

要求

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

另请参阅

EVENT_DESCRIPTOR

PROVIDER_EVENT_INFO

TRACE_EVENT_INFO

TdhEnumerateManifestProviderEvents