IHostSecurityContext::Capture-metod

Hämtar en klon av IHostSecurityContext-instansen som returneras från ett anrop till IHostSecurityManager::GetSecurityContext.

Syntax

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

Parametrar

ppClonedContext
[ut] En pekare till adressen för en klon av objektet som IHostSecurityContext ska avbildas.

Returvärde

HRESULT	Description
S_OK	Capture returnerades korrekt.
HOST_E_CLRNOTAVAILABLE	CLR (Common Language Runtime) har inte lästs in i en process, eller så är CLR i ett tillstånd där den inte kan köra hanterad kod eller bearbeta anropet.
HOST_E_TIMEOUT	Samtalets tidsgräns överst.
HOST_E_NOT_OWNER	Anroparen äger inte låset.
HOST_E_ABANDONED	En händelse avbröts medan en blockerad tråd eller fiber väntade på den.
E_FAIL	Ett okänt oåterkalleligt fel inträffade. När en metod returnerar E_FAIL kan CLR inte längre användas i processen. Efterföljande anrop till värdmetoder returnerar HOST_E_CLRNOTAVAILABLE.

Kommentarer

Gränssnittspekaren som returneras från Capture är en klon av den insamlade kontexten. När den här informationen flyttas över en asynkron kodpunkt separeras dess livslängd från den pekare som anropet gjordes mot. Den ursprungliga pekaren kan därför släppas.

Krav

Plattformar: Se Systemkrav.

Huvudet: MSCorEE.h

Bibliotek: Ingår som en resurs i MSCorEE.dll

.NET Framework versioner: Tillgänglig sedan 2.0

Se även

• IHostSecurityContext-gränssnitt
• IHostSecurityManager-gränssnitt