IHostSecurityContext::Capture – metoda

Získá klon IHostSecurityContext instance vrácené z volání IHostSecurityManager::GetSecurityContext.

Syntaxe

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

Parametry

ppClonedContext
[out] Ukazatel na adresu klonu objektu, který IHostSecurityContext má být zachycen.

Návratová hodnota

HRESULT	Description
S_OK	Capture úspěšně vráceno.
HOST_E_CLRNOTAVAILABLE	Modul CLR (Common Language Runtime) nebyl načten do procesu nebo je ve stavu, ve kterém nemůže spustit spravovaný kód nebo úspěšně zpracovat volání.
HOST_E_TIMEOUT	Časový limit hovoru vypršel.
HOST_E_NOT_OWNER	Volající zámek nevlastní.
HOST_E_ABANDONED	Událost byla zrušena, když na ni čekalo blokované vlákno nebo vlákno.
E_FAIL	Došlo k neznámému katastrofickému selhání. Když metoda vrátí E_FAIL, CLR už není v rámci procesu použitelný. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE.

Poznámky

Ukazatel rozhraní vrácený z Capture je klonem zachyceného kontextu. Když se tyto informace přesunou přes asynchronní bod kódu, jeho životnost je oddělena od doby trvání ukazatele, proti kterému bylo volání provedeno. Původní ukazatel lze proto uvolnit.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: MSCorEE.h

Knihovny: Zahrnuto jako prostředek v MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 2.0

Viz také

• IHostSecurityContext – rozhraní
• IHostSecurityManager – rozhraní