다음을 통해 공유

IActionOnCLREvent::OnEvent 메서드

  • 아티클

ICLROnEventManager::RegisterActionOnEvent 메서드 호출을 사용하여 등록된 이벤트에 대한 콜백을 수행합니다.

구문

HRESULT OnEvent (  
    [in] EClrEvent event,  
    [in] PVOID     data  
);

매개 변수

event
[in] 이벤트 형식을 나타내는 EClrEvent 값 중 하나입니다.

data
[in] event에 대한 세부 정보가 포함된 개체에 대한 포인터입니다.

Return Value

HRESULT 설명
S_OK OnEvent가 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE CLR(공용 언어 런타임)이 프로세스에 로드되지 않았거나 CLR이 관리 코드를 실행하거나 호출을 성공적으로 처리할 수 없는 상태에 있습니다.
HOST_E_TIMEOUT 호출 시간이 초과되었습니다.
HOST_E_NOT_OWNER 호출자는 잠금을 소유하지 않습니다.
HOST_E_ABANDONED 차단된 스레드 또는 파이버가 이벤트를 기다리는 동안 이벤트가 취소되었습니다.
E_FAIL 알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환하면 CLR은 프로세스 내에서 더 이상 사용할 수 없습니다. 모든 호스팅 메서드에 대한 후속 호출은 HOST_E_CLRNOTAVAILABLE을 반환합니다.

설명

data 매개 변수는 지정되지 않은 형식의 개체에 대한 포인터입니다. event 매개 변수가 Event_DomainUnload인 경우 data는 언로드된 AppDomain의 숫자 식별자입니다. 호스트는 이 식별자를 키로 사용하여 적절한 작업을 수행할 수 있습니다.

event가 Event_MDAFired이면 data는 MDA(Managed Debugging Assistant)의 메시지 출력이 포함된 MDAInfo 인스턴스에 대한 포인터입니다. MDA는 트래핑하기 어려운 이벤트에 대한 XML 메시지를 생성하여 개발자의 디버깅을 돕는 CLR의 기능입니다. 이러한 메시지는 관리 코드와 비관리 코드 간의 전환을 디버깅하는 데 특히 유용할 수 있습니다. 자세한 내용은 관리 디버깅 도우미로 오류 진단을 참조하세요.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: MSCorEE.h

라이브러리: 리소스로 MSCorEE.dll에 포함됩니다.

.NET Framework 버전: 2.0부터 사용 가능

참고 항목