ICorDebugHeapValue3::GetMonitorEventWaitList — Metoda
Udostępnia uporządkowaną listę wątków, które są kolejkowane w zdarzeniu skojarzonym z blokadą monitora.
Składnia
HRESULT GetMonitorEventWaitList (
[out] ICorDebugThreadEnum **ppThreadEnum
);
Parametry
ppThreadEnum
[out] Moduł wyliczający ICorDebugThreadEnum, który udostępnia uporządkowaną listę wątków.
Wartość zwracana
Ta metoda zwraca następujące określone elementy HRESULTs, a także błędy HRESULT wskazujące niepowodzenie metody.
HRESULT | opis |
---|---|
S_OK | Lista nie jest pusta. |
S_FALSE | Lista jest pusta. |
Wyjątki
Uwagi
Pierwszy wątek na liście to pierwszy wątek, który jest zwalniany przez następne wywołanie metody Monitor.Pulse(Object). Następny wątek na liście zostanie wydany przy użyciu następującego wywołania itd.
Jeśli lista nie jest pusta, ta metoda zwraca S_OK. Jeśli lista jest pusta, metoda zwraca S_FALSE; w tym przypadku wyliczenie jest nadal prawidłowe, chociaż jest puste.
W obu przypadkach interfejs wyliczania może być używany tylko przez czas trwania bieżącego stanu synchronizacji. Jednak interfejsy wątku zwalniane z niego są prawidłowe do momentu zakończenia wątku.
Jeśli ppThreadEnum
nie jest prawidłowym wskaźnikiem, wynik jest niezdefiniowany.
Jeśli wystąpi błąd, którego nie można określić, które wątki oczekują na monitor, metoda zwraca wartość HRESULT wskazującą błąd.
Wymagania
Platformy: zobacz Wymagania systemowe.
Nagłówek: CorDebug.idl, CorDebug.h
Biblioteka: CorGuids.lib
Wersje programu .NET Framework: dostępne od 4