Метод 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