Udostępnij za pośrednictwem


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

Zobacz też