Compartir a través de

IHostSecurityManager::GetSecurityContext (Método)

  • Artículo

Obtiene el elemento IHostSecurityContext solicitado del host.

Sintaxis

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

Parámetros

eContextType
[in] Uno de los valores EContextType, que indica qué tipo de contexto de seguridad se va a devolver.

ppSecurityContext
[out] Dirección de un puntero de interfaz al elemento IHostSecurityContext de eContextType.

Valor devuelto

HRESULT Descripción
S_OK GetSecurityContext se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE El Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar 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 autor de la llamada no es el propietario del bloqueo.
HOST_E_ABANDONED Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando.
E_FAIL Ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE.

Comentarios

Un host puede controlar por completo el acceso del código a los tokens de subproceso mediante el uso del motor CLR y el código de usuario. También puede asegurarse de que la información completa del contexto de seguridad se pase mediante operaciones asincrónicas o de puntos de código con acceso restringido al código. Gracias a la interfaz IHostSecurityContext es posible encapsular esta información de contexto de seguridad y mantenerla opaca con respecto a CLR. CLR captura esta información y la mueve por el envío de elementos de trabajo del grupo de subprocesos, la ejecución del finalizador, y la construcción de módulos y clases.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también