IHostSecurityManager::GetSecurityContext-Methode

Artikel
06/02/2023

Ruft den angeforderten IHostSecurityContext vom Host ab.

Syntax

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

Parameter

eContextType
[in] Einer der EContextType-Werte, der angibt, welcher Typ von Sicherheitskontext zurückgegeben werden soll.

ppSecurityContext
[out] Die Adresse eines Schnittstellenzeigers die IHostSecurityContext von eContextType.

Rückgabewert

HRESULT	BESCHREIBUNG
S_OK	`GetSecurityContext` wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Timeout des Aufrufs.
HOST_E_NOT_OWNER	Der Aufrufer besitzt die Sperre nicht.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat.
E_FAIL	Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Bemerkungen

Ein Host kann den gesamten Codezugriff auf Threadtoken sowohl durch die CLR als auch über den Benutzercode steuern. Außerdem kann sichergestellt werden, dass vollständige Sicherheitskontextinformationen über asynchrone Vorgänge oder Codepunkte mit eingeschränktem Codezugriff übergeben werden. IHostSecurityContext kapselt diese Sicherheitskontextinformationen, die für die CLR nicht transparent sind. Die CLR erfasst diese Informationen und verschiebt sie über die Verteilung von Threadpool-Workerelementen, die Ausführung des Finalizers sowie über Modul- und Klassenkonstruktion.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.

.NET Framework-Versionen: Seit 2.0 verfügbar.

Freigeben über