EvtNextPublisherId function

Gets the identifier of a provider from the enumerator.

Syntax


BOOL WINAPI EvtNextPublisherId(
  _In_   EVT_HANDLE PublisherEnum,
  _In_   DWORD PublisherIdBufferSize,
  _In_   LPWSTR PublisherIdBuffer,
  _Out_  PDWORD PublisherIdBufferUsed
);

Parameters

PublisherEnum [in]

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

PublisherIdBufferSize [in]

The size of the PublisherIdBuffer buffer, in characters.

PublisherIdBuffer [in]

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.

PublisherIdBufferUsed [out]

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/valueDescription
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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

WinEvt.h

Library

Wevtapi.lib

DLL

Wevtapi.dll

See also

EvtOpenPublisherMetadata

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.