Partager via

IHostSecurityContext::Capture, méthode

  • Article

Obtient un clone de l’instance IHostSecurityContext retournée par un appel à IHostSecurityManager::GetSecurityContext.

Syntaxe

HRESULT Capture (  
    [out] IHostSecurityContext** ppClonedContext  
);

Paramètres

ppClonedContext
[out] Pointeur vers l’adresse d’un clone de l’objet IHostSecurityContext à capturer.

Valeur de retour

HRESULT Description
S_OK Capture retourné.
HOST_E_CLRNOTAVAILABLE Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel avec succès.
HOST_E_TIMEOUT L’appel a expiré.
HOST_E_NOT_OWNER L’appelant n’est pas propriétaire du verrou.
HOST_E_ABANDONED Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait.
E_FAIL Une défaillance catastrophique inconnue s’est produite. Quand une méthode retourne E_FAIL, le CLR n’est plus utilisable au sein du processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE.

Notes

Le pointeur d’interface retourné à partir de Capture est un clone du contexte capturé. Lorsque ces informations sont déplacées sur un code de caractère asynchrone, sa durée de vie est séparée de celle du pointeur sur lequel l’appel a été effectué. Le pointeur d’origine peut donc être libéré.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponible depuis la version 2.0

Voir aussi