IHostSecurityContext::Capture, méthode
Mise à jour : novembre 2007
Obtient un clone de l'instance IHostSecurityContext retournée par un appel à IHostSecurityManager::GetSecurityContext.
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 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
Le pointeur d'interface retourné de Capture est un clone du contexte capturé. Lorsque ces informations sont déplacées à travers un point de code asynchrone, leur durée de vie est séparée de celle du pointeur par rapport auquel l'appel a été fait. Le pointeur d'origine peut par conséquent être libéré.
Configuration requise
Plateformes : consultez Configuration requise du .NET Framework.
En-tête : MSCorEE.idl
Bibliothèque : incluse en tant que ressource dans MSCorEE.dll
Versions du .NET Framework : 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0