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