EvtClose 함수(winevt.h)
열린 핸들을 닫습니다.
구문
BOOL EvtClose(
[in] EVT_HANDLE Object
);
매개 변수
[in] Object
닫을 열린 이벤트 핸들입니다.
반환 값
반환 코드/값 | 설명 |
---|---|
|
함수가 성공했습니다. |
|
함수가 실패했습니다. 오류 코드를 얻으려면 GetLastError 함수를 호출합니다. |
설명
핸들을 닫은 후에는 핸들을 사용할 수 없습니다. 부모 핸들을 닫으면 핸들을 사용하여 만든 열린 핸들도 닫힙니다. 예를 들어 이벤트를 쿼리하는 경우 쿼리 결과에는 쿼리와 일치하는 각 이벤트에 대한 핸들이 포함됩니다. 모범 사례에서는 이벤트를 완료할 때 각 이벤트 핸들을 닫는 것이 좋습니다. 그렇지 않은 경우 쿼리 핸들을 닫으면 모든 이벤트 핸들도 닫힙니다.
요구 사항
지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | winevt.h |
라이브러리 | Wevtapi.lib |
DLL | Wevtapi.dll |