IHostSecurityManager::GetSecurityContext — Metoda
Pobiera żądany element IHostSecurityContext z hosta.
Składnia
HRESULT GetSecurityContext (
[in] EContextType eContextType,
[out] IHostSecurityContext** ppSecurityContext
);
Parametry
eContextType
[in] Jedna z wartości EContextType wskazująca, jaki typ kontekstu zabezpieczeń ma być zwracany.
ppSecurityContext
[out] Adres wskaźnika interfejsu do elementu IHostSecurityContext
eContextType
.
Wartość zwracana
HRESULT | Opis |
---|---|
S_OK | GetSecurityContext zwrócone pomyślnie. |
HOST_E_CLRNOTAVAILABLE | Środowisko uruchomieniowe języka wspólnego (CLR) nie zostało załadowane do procesu lub clR jest w stanie, w którym nie może uruchomić kodu zarządzanego ani pomyślnie przetworzyć wywołania. |
HOST_E_TIMEOUT | Upłynął limit czasu wywołania. |
HOST_E_NOT_OWNER | Obiekt wywołujący nie jest właścicielem blokady. |
HOST_E_ABANDONED | Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie. |
E_FAIL | Wystąpił nieznany katastrofalny błąd. Gdy metoda zwraca E_FAIL, clR nie będzie już można jej używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE. |
Uwagi
Host może kontrolować cały dostęp kodu do tokenów wątków zarówno za pomocą środowiska CLR, jak i kodu użytkownika. Może również zapewnić przekazywanie pełnych informacji o kontekście zabezpieczeń w operacjach asynchronicznych lub punktach kodu z ograniczonym dostępem do kodu. IHostSecurityContext
hermetyzuje te informacje kontekstowe zabezpieczeń, które są nieprzezroczyste dla środowiska CLR. ClR przechwytuje te informacje i przenosi je między wysyłaniem elementów roboczych puli wątków, wykonywaniem finalizatora oraz konstruowanie modułów i klas.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: MSCorEE.h
Biblioteki: Uwzględnione jako zasób w MSCorEE.dll
wersje .NET Framework: dostępne od wersji 2.0