Condividi tramite

Metodo IHostSecurityContext::Capture

  • Articolo

Ottiene un clone dell'istanza IHostSecurityContext restituita da una chiamata a IHostSecurityManager::GetSecurityContext.

Sintassi

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

Parametri

ppClonedContext
[out] Puntatore all'indirizzo di un clone dell'oggetto IHostSecurityContext da acquisire.

Valore restituito

HRESULT Descrizione
S_OK Capture restituito correttamente.
HOST_E_CLRNOTAVAILABLE Common Language Runtime (CLR) non è stato caricato in un processo oppure CLR si trova in uno stato in cui non è possibile eseguire codice gestito o elaborare correttamente la chiamata.
HOST_E_TIMEOUT Timeout della chiamata.
HOST_E_NOT_OWNER Il chiamante non possiede il blocco.
HOST_E_ABANDONED Un evento è stato annullato durante l'attesa di un thread o di una fibra bloccata.
E_FAIL Si è verificato un errore irreversibile sconosciuto. Quando un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE.

Commenti

Il puntatore di interfaccia restituito da Capture è un clone del contesto acquisito. Quando queste informazioni vengono spostate in un punto di codice asincrono, la relativa durata viene separata da quella del puntatore rispetto al quale è stata effettuata la chiamata. Il puntatore originale può quindi essere rilasciato.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile dalla versione 2.0

Vedi anche