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
程式庫	Wevtapi.lib
Dll	Wevtapi.dll

另請參閱

EvtOpenPublisherMetadata