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