IHostSecurityManager::GetSecurityContext-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Rufen Sie den angeforderten IHostSecurityContext vom Host ab.

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 auf den IHostSecurityContext von eContextType.

Rückgabewert

HRESULT	Beschreibung
S_OK	GetSecurityContext kehrte erfolgreich zurück.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Der Aufruf hat das Zeitlimit überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

Ein Host kann den gesamten Codezugriff auf Threadtoken sowohl über die CLR als auch über Benutzercode steuern. Er kann außerdem sicherstellen, dass die gesamten Sicherheitskontextinformationen über asynchrone Operationen oder Codepunkte mit eingeschränktem Codezugriff weitergegeben werden. IHostSecurityContext kapselt die Sicherheitskontextinformationen ein. Diese sind für die CLR nicht transparent. Die CLR erfasst diese Informationen und verschiebt sie über Threadpool Worker Item Dispatch, Finalizerausführung sowie Modul- und Klassenkonstruktion.