Metodo IHostSecurityManager::GetSecurityContext

Articolo
08/11/2011

Ottiene l'oggetto IHostSecurityContext richiesto dall'host.

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

Parametri

eContextType
[in] Uno dei valori di EContextType, che indica il tipo di contesto di sicurezza da restituire.
ppSecurityContext
[out] Indirizzo di un puntatore a interfaccia a IHostSecurityContext di eContextType.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	GetSecurityContext ha restituito correttamente un valore.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non è il proprietario del blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.

Note

Un host può controllare l'accesso di codice ai token di thread sia tramite CLR, sia tramite il codice utente. Può inoltre garantire che tutte le informazioni relative al contesto di sicurezza vengano passate attraverso operazioni asincrone o punti di codice con autorizzazioni di accesso di codice limitate. IHostSecurityContext incapsula queste informazioni di contesto, che risultano quindi opache a CLR Control Language Runtime acquisisce tali informazioni e le sposta per l'invio degli elementi di lavoro nel pool di thread, l'esecuzione dei finalizzatori e la costruzione dei moduli e delle classi.