IHostSecurityManager::GetSecurityContext (Método)

Artículo
08/10/2011

Obtiene del host la instancia de IHostSecurityContext solicitada.

HRESULT GetSecurityContext (
    [in]  EContextType eContextType, 
    [out] IHostSecurityContext** ppSecurityContext
);

Parámetros

eContextType
[in] Uno de los valores de EContextType, que indica el tipo de contexto de seguridad que se debe devolver.
ppSecurityContext
[out] Dirección de un puntero de interfaz a IHostSecurityContext de eContextType.

Valor devuelto

HRESULT	Descripción
S_OK	GetSecurityContext 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

Un host puede controlar todos los accesos del código a los tokens de subprocesos realizados por CLR y el código de usuario. También puede asegurarse de que toda la información de contexto de seguridad se pasa a través de operaciones asincrónicas o puntos de código con acceso restringido al código. IHostSecurityContext encapsula esta información de contexto de seguridad, que se vuelve opaca para CLR. CLR captura esta información y la mueve a través del envío de elementos de trabajo al grupo de subprocesos, la ejecución del finalizador y la construcción de módulos y de clases.