ICorDebugHeapValue3::GetMonitorEventWaitList 方法

提供執行緒的排序清單，這些執行緒在與監視鎖定相關聯的事件上排入佇列。

語法

HRESULT GetMonitorEventWaitList (  
    [out] ICorDebugThreadEnum **ppThreadEnum  
);

ppThreadEnum
[out] 提供執行緒排序清單的 ICorDebugThreadEnum 列舉程式。

這個方法會傳回下列特定的 HRESULT，以及表示方法失敗的 HRESULT 錯誤。

HRESULT	描述
S_OK	list 不是空的。
S_FALSE	清單為空白。

當下次呼叫 Monitor.Pulse(Object) 時，清單的第一個執行緒為首先釋放的執行緒。清單的下個執行緒會在下次呼叫時釋放，依此類推。

如果清單不是空白，此方法會傳回 S_OK。如果清單為空白，則此方法會傳回 S_FALSE；在此情況下，僅管清單空白但列舉仍然有效。

不論是哪種情況，列舉介面都僅可於目前同步的狀態期間使用。不過，由此分配的執行緒介面會持續有效，直到執行緒結束為止。

如果 ppThreadEnum 非有效指標，則結果為未定義。

如果發生錯誤，因此無法判斷是否有任何執行緒正在等候監視器，則此方法會傳回 HRESULT，表示失敗。

平台：請參閱系統需求。

標頭：CorDebug.idl、CorDebug.h

程式庫：CorGuids.lib

.NET Framework版本：自 4 起可用