Метод ICLROnEventManager::RegisterActionOnEvent
Регистрирует указатель обратного вызова для заданного события.
HRESULT RegisterActionOnEvent (
[in] EClrEvent event,
[in] IActionOnCLREvent *pAction
);
Параметры
event
[in] Одно из значений EClrEvent, задающих событие, для которого необходимо зарегистрировать указатель обратного вызова, описанный параметром pAction.pAction
[in] Указатель на объект IActionOnCLREvent, вызываемый при возникновении зарегистрированного события.
Возвращаемое значение
HRESULT |
Описание |
|---|---|
S_OK |
Метод RegisterActionOnEvent успешно возвратил значение. |
HOST_E_CLRNOTAVAILABLE |
Среда CLR не загружена в процесс или находится в состоянии, в котором ей не удается выполнить управляемый код или успешно обработать вызов. |
HOST_E_TIMEOUT |
Время ожидания вызова истекло. |
HOST_E_NOT_OWNER |
Вызывающий объект не владеет блокировкой. |
HOST_E_ABANDONED |
Событие, которого ожидал заблокированный поток или нить, было отменено. |
E_FAIL |
Произошел неизвестный разрушительный сбой. После того как метод вернет значение E_FAIL, среду CLR более нельзя будет использовать в данном процессе. Последующие вызовы методов размещения возвращают значение HOST_E_CLRNOTAVAILABLE. |
Заметки
Основное приложение может зарегистрировать обратные вызовы для обоих или любого из двух типов событий, описанных EClrEvent. Основное приложение получает интерфейс ICLROnEventManager, вызвав метод ICLRControl::GetCLRManager.
.gif "Примечание") Примечание |
|---|
События, инициируемые методом RegisterActionOnEvent, можно вызывать несколько раз и из разных потоков, подавая с их помощью сигнал о выгрузке или отключении среды CLR. |
Требования
Платформы: см. раздел Требования к системе для .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