EvtNextChannelPath 函式 (winevt.h)

  • 發行項

從列舉值取得通道名稱。

語法

BOOL EvtNextChannelPath(
  [in]  EVT_HANDLE ChannelEnum,
  [in]  DWORD      ChannelPathBufferSize,
  [in]  LPWSTR     ChannelPathBuffer,
  [out] PDWORD     ChannelPathBufferUsed
);

參數

[in] ChannelEnum

EvtOpenChannelEnum 函式傳回之列舉值的句柄。

[in] ChannelPathBufferSize

ChannelPathBuffer 緩衝區的大小，以字元為單位。

[in] ChannelPathBuffer

將接收通道名稱的呼叫端配置緩衝區。 您可以將此參數設定為 NULL ，以判斷所需的緩衝區大小。

[out] ChannelPathBufferUsed

如果函式因ERROR_INSUFFICIENT_BUFFER而失敗，則呼叫端配置緩衝區的大小，或所需的緩衝區大小。

傳回值

傳回碼/值 Description
TRUE
 此函數已成功。
FALSE
 函式失敗。 若要取得錯誤碼，請呼叫 GetLastError 函式。

備註

在迴圈中呼叫此函式，直到函式傳回 FALSE 且錯誤碼ERROR_NO_MORE_ITEMS為止。

範例

如需示範如何使用此函式的範例，請參閱 取得和設定通道的組態屬性。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 winevt.h
程式庫 Wevtapi.lib
Dll Wevtapi.dll

另請參閱

EvtOpenChannelEnum