Ескертпе
Бұл бетке кіру үшін қатынас шегін айқындау қажет. Жүйеге кіруді немесе каталогтарды өзгертуді байқап көруге болады.
Бұл бетке кіру үшін қатынас шегін айқындау қажет. Каталогтарды өзгертуді байқап көруге болады.
Возвращает экземпляр IHostTask , которому принадлежит монитор, определенный указанным файлом cookie.
Синтаксис
HRESULT GetMonitorOwner (
[in] SIZE_T cookie,
[out] IHostTask *ppOwnerHostTask
);
Параметры
cookie
[in] Файл cookie, связанный с монитором.
ppOwnerHostTask
[out] Указатель на объект , IHostTask которому в данный момент принадлежит монитор, или значение NULL, если ни у какой задачи нет прав владения.
Возвращаемое значение
| HRESULT | Описание: |
|---|---|
| S_OK |
GetMonitorOwner возвращается успешно. |
| HOST_E_CLRNOTAVAILABLE | Среда CLR не была загружена в процесс или среда CLR находится в состоянии, в котором она не может выполнить управляемый код или обработать вызов. |
| HOST_E_TIMEOUT | Истекло время ожидания звонка. |
| HOST_E_NOT_OWNER | Вызывающий объект не является владельцем блокировки. |
| HOST_E_ABANDONED | Событие было отменено во время ожидания заблокированного потока или волокна. |
| E_FAIL | Произошла неизвестная катастрофическая ошибка. Когда метод возвращает E_FAIL, среда CLR больше не поддерживается в процессе. Последующие вызовы методов размещения возвращают HOST_E_CLRNOTAVAILABLE. |
Комментарии
Узел обычно вызывает GetMonitorOwner как часть механизма обнаружения взаимоблокировок. Файл cookie связывается с монитором при его создании с помощью вызова IHostSyncManager::CreateMonitorEvent.
Примечание
Вызов для освобождения события, лежащего в основе монитора, может блокироваться, но не будет взаимоблокировкой, если вызов этого метода в настоящее время действует на файл cookie, связанный с этим монитором. Другие задачи также могут блокироваться при попытке получить этот монитор.
GetMonitorOwner всегда возвращает немедленно и может быть вызван в любое время после вызова CreateMonitorEventметода . Ведущему приложению не нужно ждать, пока задача ожидает события.
Требования
Платформы: см. раздел Требования к системе.
Заголовка: MSCorEE.h
Библиотека: Включено в качестве ресурса в MSCorEE.dll
версии платформа .NET Framework: доступно с версии 2.0