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