Udostępnij za pośrednictwem

IHostSecurityContext::Capture — Metoda

  • Artykuł

Pobiera klon wystąpienia IHostSecurityContext zwrócony z wywołania IHostSecurityManager::GetSecurityContext.

Składnia

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

Parametry

ppClonedContext
[out] Wskaźnik do adresu klonowania IHostSecurityContext obiektu do przechwycenia.

Wartość zwracana

HRESULT Opis
S_OK Capture zwrócono 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 używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE.

Uwagi

Wskaźnik interfejsu zwrócony z Capture jest klonem przechwyconego kontekstu. Gdy te informacje są przenoszone przez punkt kodu asynchronicznego, jego okres istnienia jest oddzielony od wskaźnika, względem którego zostało wykonane wywołanie. W związku z tym można zwolnić oryginalny wskaźnik.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: MSCorEE.h

Biblioteki: Uwzględnione jako zasób w MSCorEE.dll

.NET Framework wersje: dostępne od wersji 2.0

Zobacz też