IActionOnCLREvent::OnEvent 메서드

아티클
08/09/2011

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

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

매개 변수

event
[in] 이벤트 형식을 나타내는 EClrEvent 값 중 하나입니다.
data
[in] 상세한 event 정보를 포함하는 개체에 대한 포인터입니다.

반환 값

HRESULT	설명
S_OK	OnEvent에서 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE	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(관리 디버깅 도우미)에서 출력된 메시지를 포함하는 MDAInfo에 대한 포인터입니다. MDA는 쉽게 트래핑할 수 없는 이벤트에 대한 XML 메시지를 생성하여 개발자의 디버깅 작업을 도와 주는 CLR 기능입니다. 이러한 메시지는 특히 관리 코드와 비관리 코드 간의 전환을 디버깅할 때 유용합니다. 자세한 내용은 관리 디버깅 도우미를 사용하여 오류 진단을 참조하십시오.