Dela via


ICLRSyncManager::GetMonitorOwner-metod

Hämtar den IHostTask-instans som äger övervakaren som identifierats av den angivna cookien.

Syntax

HRESULT GetMonitorOwner (  
    [in]  SIZE_T     cookie,  
    [out] IHostTask *ppOwnerHostTask  
);  

Parametrar

cookie
[i] Den cookie som är associerad med övervakaren.

ppOwnerHostTask
[ut] En pekare till IHostTask den som för närvarande äger övervakaren eller null om ingen aktivitet har ägarskap.

Returvärde

HRESULT Description
S_OK GetMonitorOwner returnerades korrekt.
HOST_E_CLRNOTAVAILABLE CLR 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

Värden anropar GetMonitorOwner vanligtvis som en del av en mekanism för identifiering av dödläge. Cookien associeras med en övervakare när den skapas med hjälp av ett anrop till IHostSyncManager::CreateMonitorEvent.

Anteckning

Ett anrop för att släppa händelsen som ligger till grund för övervakaren kan blockera – men kommer inte att blockeras – om ett anrop till den här metoden för närvarande gäller för den cookie som är associerad med övervakaren. Andra uppgifter kan också blockeras om de försöker hämta den här övervakaren.

GetMonitorOwner returnerar alltid omedelbart och kan anropas när som helst efter ett anrop till CreateMonitorEvent. Värden behöver inte vänta tills en aktivitet väntar på händelsen.

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