Метод IActionOnCLREvent::OnEvent

Статья
08/11/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 является указателем на экземпляр MDAInfo, содержащий выходные данные сообщения, поступившего от управляемого помощника по отладке (MDA). Помощники MDA — это функция среды CLR, которая помогает разработчикам при отладке, создавая сообщения XML относительно событий, перехватить которые в противном случае было бы сложно. Такие сообщения могут быть особенно полезными при взаимных переходах между управляемым и неуправляемым кодом во время отладки. Дополнительные сведения см. в разделе Диагностика ошибок посредством управляемых помощников по отладке.

Требования

Платформы: см. раздел Требования к системе для .NET Framework.

Заголовок: MSCorEE.h

Библиотека: включена как ресурс в MSCorEE.dll

Версии платформы .NET Framework: 4, 3.5 с пакетом обновления 1 (SP1), 3.5, 3.0 с пакетом обновления 1 (SP1), 3.0, 2.0 с пакетом обновления 1 (SP1), 2.0