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


Метод IHostSecurityContext::Capture

Обновлен: Ноябрь 2007

Получает клон экземпляра IHostSecurityContext, возвращенного в результате вызова метода IHostSecurityManager::GetSecurityContext.

HRESULT Capture (
    [out] IHostSecurityContext** ppClonedContext
);

Параметры

  • ppClonedContext
    [out] Указатель на адрес клона перехватываемого объекта IHostSecurityContext.

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

HRESULT

Описание

S_OK

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

HOST_E_CLRNOTAVAILABLE

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

HOST_E_TIMEOUT

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

HOST_E_NOT_OWNER

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

HOST_E_ABANDONED

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

E_FAIL

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

Заметки

Указатель интерфейса, возвращенный методом Capture, является клоном перехваченного контекста. При перемещении этих сведений по асинхронным точкам кода время их существования отсчитывается независимо от времени существования указателя, в отношении которого осуществлялся вызов. Поэтому исходный указатель можно освободить.

Требования

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

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

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

Версии платформы .NET Framework: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

См. также

Ссылки

Интерфейс IHostSecurityContext

Интерфейс IHostSecurityManager