EvtClearLog 함수(winevt.h)

지정된 채널에서 모든 이벤트를 제거하고 대상 로그 파일에 씁니다.

구문

BOOL EvtClearLog(
  [in, optional] EVT_HANDLE Session,
  [in]           LPCWSTR    ChannelPath,
  [in, optional] LPCWSTR    TargetFilePath,
  [in]           DWORD      Flags
);

매개 변수

[in, optional] Session

EvtOpenSession 함수가 반환하는 원격 세션 핸들입니다. 로컬 채널의 경우 NULL 로 설정합니다.

[in] ChannelPath

지울 채널의 이름입니다.

[in, optional] TargetFilePath

이벤트를 수신할 대상 로그 파일의 전체 경로입니다. NULL로 설정하여 로그 파일을 지우고 이벤트를 저장하지 않습니다.

[in] Flags

예약되어 있습니다. 0이어야 합니다.

반환 값

반환 코드/값	설명
TRUE	함수가 성공했습니다.
FALSE	함수가 실패했습니다. GetLastError 함수를 사용하여 오류 코드를 가져옵니다.

설명

채널 또는 로그 파일에서 이벤트를 복사하려면 EvtExportLog 함수를 호출합니다.

대상 로그 파일의 절대 경로를 지정해야 합니다. 상대 경로 및 환경 변수를 사용하여 대상 로그 파일을 지정할 수 없습니다. 경로는 UNC(범용 명명 규칙) 경로일 수 있습니다. .evtx를 파일 이름 확장자로 사용해야 합니다.

이 함수는 채널에만 영향을 줍니다. 채널에서 autoBackup 또는 fileMax를 사용하는 경우 이 함수는 해당 백업 파일에 영향을 미치지 않습니다.

요구 사항

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

추가 정보

EvtArchiveExportedLog

EvtExportLog