EvtOpenLog 함수(winevt.h)

채널 또는 로그 파일에 대한 정보를 가져오는 데 사용할 수 있는 채널 또는 로그 파일에 대한 핸들을 가져옵니다.

구문

EVT_HANDLE EvtOpenLog(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    Path,
  [in] DWORD      Flags
);

[in] Session

EvtOpenSession 함수가 반환하는 원격 세션 핸들입니다. NULL로 설정하여 채널을 열거나 로컬 컴퓨터에 로그온합니다.

[in] Path

채널 이름 또는 내보낸 로그 파일의 전체 경로입니다.

[in] Flags

Path 매개 변수가 로그 파일 또는 채널을 가리키는지 여부를 결정하는 플래그입니다. 가능한 값은 EVT_OPEN_LOG_FLAGS 열거형을 참조하세요.

성공하면 함수는 파일 또는 채널에 대한 핸들을 반환합니다. 그렇지 않으면 NULL입니다. NULL인 경우 GetLastError 함수를 호출하여 오류 코드를 가져옵니다.

파일을 지정할 때 상대 경로 및 환경 변수를 사용할 수 없습니다. UNC(범용 명명 규칙) 경로를 사용하여 파일을 찾을 수 있습니다. API를 호출하기 전에 상대 경로 및 환경 변수 확장을 수행해야 합니다.

채널 또는 로그 파일에 대한 정보를 얻으려면 EvtGetLogInfo 함수를 호출합니다.