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 실패하는 경우 필요한 버퍼 크기입니다.

반환 값

반환 코드/값	설명
TRUE	함수가 성공했습니다.
FALSE	함수가 실패했습니다. 오류 코드를 얻으려면 GetLastError 함수를 호출합니다.

설명

함수가 FALSE 를 반환하고 오류 코드가 ERROR_NO_MORE_ITEMS 때까지 루프에서 이 함수를 호출합니다.

예제

이 함수를 사용하는 방법을 보여 주는 예제는 채널의 구성 속성 가져오기 및 설정을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winevt.h
라이브러리	Wevtapi.lib
DLL	Wevtapi.dll

추가 정보

EvtOpenChannelEnum