Delen via


Methode IHostSecurityContext::Capture

Hiermee wordt een kloon opgehaald van het IHostSecurityContext-exemplaar dat is geretourneerd na een aanroep naar IHostSecurityManager::GetSecurityContext.

Syntaxis

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

Parameters

ppClonedContext
[uit] Een verwijzing naar het adres van een kloon van het IHostSecurityContext object dat moet worden vastgelegd.

Retourwaarde

HRESULT Beschrijving
S_OK Capture is geretourneerd.
HOST_E_CLRNOTAVAILABLE De COMMON Language Runtime (CLR) is niet geladen in een proces of de CLR heeft een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt.
HOST_E_TIMEOUT Er is een time-out opgetreden voor het gesprek.
HOST_E_NOT_OWNER De beller is niet de eigenaar van het slot.
HOST_E_ABANDONED Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of glasvezel op wachtte.
E_FAIL Er is een onbekende catastrofale fout opgetreden. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE.

Opmerkingen

De interfacepointer die wordt geretourneerd van Capture is een kloon van de vastgelegde context. Wanneer deze informatie wordt verplaatst naar een asynchroon codepunt, wordt de levensduur gescheiden van die van de aanwijzer waarmee de aanroep is gedaan. De oorspronkelijke aanwijzer kan daarom worden losgelaten.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 2.0

Zie ook