EvtGetExtendedStatus 函数 (winevt.h)

  • 项目

获取包含当前错误的扩展错误信息的文本消息。

语法

DWORD EvtGetExtendedStatus(
  [in]  DWORD  BufferSize,
  [in]  LPWSTR Buffer,
  [out] PDWORD BufferUsed
);

参数

[in] BufferSize

缓冲区的大小（以字符为单位）。

[in] Buffer

将接收扩展错误信息的调用方分配的字符串缓冲区。 可以将此参数设置为 NULL ，以确定所需的缓冲区大小。

[out] BufferUsed

函数使用的调用方分配的缓冲区的大小（以字符为单位），如果函数失败并出现ERROR_INSUFFICIENT_BUFFER，则为所需的缓冲区大小。

返回值

如果调用成功，则返回值ERROR_SUCCESS;否则为 Win32 错误代码。

注解

在调用另一个 Windows 事件日志函数之前，必须在生成错误的线程上调用此函数。

如果指定的 XPath 出现问题， EvtQuery 和 EvtSubscribe 函数可以提供扩展的错误信息。 例如，错误信息可以标识发生分析错误的 XPath 中的字符。 若要接收格式错误的 XPath 的扩展错误信息，不能在调用 EvtQuery 或 EvtSubscribe 时指定 EvtQueryTolerateQueryErrors 标志。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 winevt.h
Library Wevtapi.lib
DLL Wevtapi.dll