Поделиться через


Метод IHostSyncManager::CreateMonitorEvent

Создает объект события отслеживаемого автоматического сброса.

HRESULT CreateMonitorEvent (
    [in]  SIZE_T cookie,
    [out] IHostAutoEvent **ppEvent
);

Параметры

  • cookie
    [in] Файл Cookie, который необходимо связать с объектом события.

  • ppEvent
    [out] Указатель на адрес экземпляра IHostAutoEvent или NULL, если объект события создать не удалось.

Возвращаемое значение

HRESULT

Описание

S_OK

Метод CreateMonitorEvent успешно возвратил значение.

HOST_E_CLRNOTAVAILABLE

Среда CLR не загружена в процесс или находится в состоянии, в котором ей не удается выполнить управляемый код или успешно обработать вызов.

HOST_E_TIMEOUT

Время ожидания вызова истекло.

HOST_E_NOT_OWNER

Вызывающий объект не владеет блокировкой.

HOST_E_ABANDONED

Событие, которого ожидал заблокированный поток или нить, было отменено.

E_FAIL

Произошел неизвестный разрушительный сбой. Если метод вернет значение E_FAIL, среду CLR более нельзя будет использовать в данном процессе. Последующие вызовы методов размещения возвращают значение HOST_E_CLRNOTAVAILABLE.

E_OUTOFMEMORY

Недостаточно памяти для создания запрошенного объекта события.

Заметки

Метод CreateMonitorEvent возвращает объект IHostAutoEvent, который среда CLR использует в его реализации управляемого типа System.Threading.Monitor. Этот метод создает отражение функции CreateEvent для Win32 со значением false, заданным для параметра bManualReset.

Основное приложение может использовать файл Cookie для определения задач, ожидающих проверки посредством вызова метода ICLRSyncManager::GetMonitorOwner.

Требования

Платформы: см. раздел Требования к системе для .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

См. также

Ссылки

Интерфейс ICLRSyncManager

Интерфейс IHostAutoEvent

Интерфейс IHostSyncManager

Основные понятия

Мониторы