EvtOpenSession 함수(winevt.h)
다른 Windows 이벤트 로그 함수를 호출할 때 사용할 수 있는 원격 컴퓨터에 대한 연결을 설정합니다.
구문
EVT_HANDLE EvtOpenSession(
[in] EVT_LOGIN_CLASS LoginClass,
[in] PVOID Login,
[in] DWORD Timeout,
[in] DWORD Flags
);
매개 변수
[in] LoginClass
원격 컴퓨터에 연결하는 데 사용할 연결 방법입니다. 가능한 값은 EVT_LOGIN_CLASS 열거형을 참조하세요.
[in] Login
연결할 원격 컴퓨터, 사용자의 자격 증명 및 연결할 때 사용할 인증 유형을 식별하는 EVT_RPC_LOGIN 구조입니다.
[in] Timeout
예약되어 있습니다. 0이어야 합니다.
[in] Flags
예약되어 있습니다. 0이어야 합니다.
반환 값
성공하면 함수는 원격 컴퓨터의 이벤트 로그 정보에 액세스하는 데 사용할 수 있는 세션 핸들을 반환합니다. 그렇지 않으면 NULL입니다. NULL인 경우 GetLastError 함수를 호출하여 오류 코드를 가져옵니다.
설명
세션 핸들을 완료하면 EvtClose 함수를 호출합니다. 세션 핸들을 닫으면 세션에서 만든 모든 열린 핸들도 닫힙니다(열린 핸들을 닫으면 해당 핸들의 현재 작업이 취소됨).
원격 컴퓨터에 연결하려면 원격 컴퓨터에서 "원격 이벤트 로그 관리" Windows 방화벽 예외를 사용하도록 설정해야 합니다. 그렇지 않으면 세션 핸들을 사용하려고 하면 RPC_S_SERVER_UNAVAILABLE 호출에 오류가 발생합니다. 연결하는 컴퓨터는 Windows Vista 이상을 실행해야 합니다.
이 함수는 자격 증명의 유효성을 검사하지 않습니다. 자격 증명은 세션 핸들을 처음 사용할 때 유효성이 검사됩니다. 자격 증명이 유효하지 않으면 ERROR_ACCESS_DENIED 호출이 실패합니다.
예제
이 함수를 사용하는 방법을 보여 주는 예제는 원격 컴퓨터 액세스를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winevt.h |
| 라이브러리 | Wevtapi.lib |
| DLL | Wevtapi.dll |