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 起提供