evtNextPublisherId 函数 (winevt.h)

从枚举器获取提供程序的标识符。

语法

BOOL EvtNextPublisherId(
  [in]  EVT_HANDLE PublisherEnum,
  [in]  DWORD      PublisherIdBufferSize,
  [in]  LPWSTR     PublisherIdBuffer,
  [out] PDWORD     PublisherIdBufferUsed
);

参数

[in] PublisherEnum

EvtOpenPublisherEnum 函数返回的已注册提供程序枚举器的句柄。

[in] PublisherIdBufferSize

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

[in] PublisherIdBuffer

一个调用方分配的缓冲区，该缓冲区将接收已注册的提供程序的名称。 可以将此参数设置为 NULL ，以确定所需的缓冲区大小。

[out] PublisherIdBufferUsed

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

返回值

返回代码/值	说明
TRUE	函数成功。
FALSE	函数失败。 若要获取错误代码，请调用 GetLastError 函数。

注解

在循环中调用此函数，直到函数返回 FALSE 且ERROR_NO_MORE_ITEMS错误代码。

此提供程序名称列表未按字母顺序排序。

示例

有关演示如何使用此函数的示例，请参阅 获取提供程序的元数据。

要求

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

另请参阅

EvtOpenPublisherMetadata