共用方式為

PWAITCHAINCALLBACK 回呼函式 (wct.h)

  • 發行項

接收等候鏈結的應用程式定義回呼函式。 呼叫 OpenThreadWaitChainSession 函 式時，請指定這個位址。

PWAITCHAINCALLBACK 類型會定義這個回呼函式的指標。 WaitChainCallback 是應用程式定義函數名稱的佔位元。

語法

PWAITCHAINCALLBACK Pwaitchaincallback;

void Pwaitchaincallback(
  HWCT WctHandle,
  DWORD_PTR Context,
  DWORD CallbackStatus,
  LPDWORD NodeCount,
  PWAITCHAIN_NODE_INFO NodeInfoArray,
  LPBOOL IsCycle
)
{...}

參數

WctHandle

OpenThreadWaitChainSession 函式所建立之 WCT 會話的句柄。

Context

GetThreadWaitChain 函式所指定之應用程式定義內容結構的選擇性指標。

CallbackStatus

回呼狀態。 此參數可以是下列其中一個值，或其中一個其他 系統錯誤碼。

值 意義
ERROR_ACCESS_DENIED
 呼叫端沒有足夠的許可權可開啟目標線程。
ERROR_CANCELLED
 異步會話已由 CloseThreadWaitChainSession 函 式的呼叫取消。
ERROR_MORE_DATA
 NodeInfoArray 緩衝區不夠大，無法包含等候鏈結中的所有節點。 NodeCount 參數包含鏈結中的節點數目。 傳回的等候鏈結仍然有效。
ERROR_OBJECT_NOT_FOUND
 無法找到指定的線程。
ERROR_SUCCESS
 作業已成功完成。
ERROR_TOO_MANY_THREADS
 節點數目超過 WCT_MAX_NODE_COUNT。 傳回的等候鏈結仍然有效。

NodeCount

擷取的節點數目，最多WCT_MAX_NODE_COUNT。 如果陣列不能包含等候鏈結的所有節點，則函式會失敗， CallbackStatus 會ERROR_MORE_DATA，而且此參數會接收包含所有節點所需的數位元素數目。

NodeInfoArray

接收等候鏈 結之WAITCHAIN_NODE_INFO 結構的陣列。

IsCycle

如果函式偵測到死結，此變數會設定為 TRUE;否則，它會設定為 FALSE。

傳回值

無

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wct.h

另請參閱

GetThreadWaitChain

OpenThreadWaitChainSession

WAITCHAIN_NODE_INFO