Edit

EvtNextPublisherId function (winevt.h)

  • Article

Gets the identifier of a provider from the enumerator.

Syntax

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

Parameters

[in] PublisherEnum

A handle to the registered providers enumerator that the EvtOpenPublisherEnum function returns.

[in] PublisherIdBufferSize

The size of the PublisherIdBuffer buffer, in characters.

[in] PublisherIdBuffer

A caller-allocated buffer that will receive the name of the registered provider. You can set this parameter to NULL to determine the required buffer size.

[out] PublisherIdBufferUsed

The size, in characters, of the caller-allocated buffer that the function used or the required buffer size if the function fails with ERROR_INSUFFICIENT_BUFFER.

Return value

Return code/value Description
TRUE
 The function succeeded.
FALSE
 The function failed. To get the error code, call the GetLastError function.

Remarks

Call this function in a loop until the function returns FALSE and the error code is ERROR_NO_MORE_ITEMS.

This list of provider names is not sorted alphabetically.

Examples

For an example that shows how to use this function, see Getting a Provider's Metadata.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header winevt.h
Library Wevtapi.lib
DLL Wevtapi.dll

See also

EvtOpenPublisherMetadata