EvtNextPublisherId function (winevt.h)
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 |
---|---|
|
The function succeeded. |
|
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 |