IHostSecurityManager::GetSecurityContext, méthode

Article
08/22/2008

Mise à jour : novembre 2007

Obtient l'IHostSecurityContext demandé auprès de l'hôte.

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

Paramètres

eContextType
[in] Une des valeurs EContextType, indiquant le type de contexte de sécurité à retourner.
ppSecurityContext
[out] Adresse d'un pointeur d'interface vers le IHostSecurityContext de eContextType.

Valeur de retour

HRESULT	Description
S_OK	GetSecurityContext a été retourné correctement.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.
HOST_E_TIMEOUT	L'appel a expiré.
HOST_E_NOT_OWNER	L'appelant ne possède pas le verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait.
E_FAIL	Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.

Notes

Un hôte peut contrôler l'accès de tout le code aux jetons de threads par le biais à la fois du CLR et du code utilisateur. Il peut également garantir que toutes les informations de contexte de sécurité sont passées via des opérations asynchrones ou des points de code ayant un accès restreint au code. IHostSecurityContext encapsule ces informations de contexte de sécurité, qui sont opaques pour le CLR. Le CLR intercepte ces informations et les déplace dans la répartition des éléments de travail du pool de threads, l'exécution du finaliseur et la construction de modules et de classes.