IHostSecurityContext::Capture (Método)
Obtiene un clon de la instancia de IHostSecurityContext devuelta en una llamada a IHostSecurityManager::GetSecurityContext.
HRESULT Capture (
[out] IHostSecurityContext** ppClonedContext
);
Parámetros
- ppClonedContext
[out] Puntero a la dirección de un clon del objeto IHostSecurityContext que se va a capturar.
Valor devuelto
HRESULT |
Descripción |
---|---|
S_OK |
Capture finalizó correctamente. |
HOST_E_CLRNOTAVAILABLE |
Common Language Runtime (CLR) no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente. |
HOST_E_TIMEOUT |
Se agotó el tiempo de espera de la llamada. |
HOST_E_NOT_OWNER |
El llamador no posee el bloqueo. |
HOST_E_ABANDONED |
Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole. |
E_FAIL |
Se ha producido un error catastrófico desconocido. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE. |
Comentarios
El puntero de interfaz devuelto por Capture es un clon del contexto capturado. Cuando esta información se desplaza por un punto de código asincrónico, su período de duración se separa de la del puntero al que se ha realizado la llamada. Por consiguiente, el puntero original puede liberarse.
Requisitos
Plataformas: vea Requisitos de sistema de .NET Framework.
Encabezado: MSCorEE.h
Biblioteca: Se incluye como recurso en MsCorEE.dll
Versiones de .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0