PWAITCHAINCALLBACK-Rückruffunktion (wct.h)
Eine anwendungsdefinierte Rückruffunktion, die eine Wartekette empfängt. Geben Sie diese Adresse beim Aufrufen der OpenThreadWaitChainSession-Funktion an.
Der PWAITCHAINCALLBACK-Typ definiert einen Zeiger auf diese Rückruffunktion. WaitChainCallback ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
Syntax
PWAITCHAINCALLBACK Pwaitchaincallback;
void Pwaitchaincallback(
HWCT WctHandle,
DWORD_PTR Context,
DWORD CallbackStatus,
LPDWORD NodeCount,
PWAITCHAIN_NODE_INFO NodeInfoArray,
LPBOOL IsCycle
)
{...}
Parameter
WctHandle
Ein Handle für die WCT-Sitzung, die von der OpenThreadWaitChainSession-Funktion erstellt wurde.
Context
Ein optionaler Zeiger auf eine anwendungsdefinierte Kontextstruktur, die von der GetThreadWaitChain-Funktion angegeben wird.
CallbackStatus
Der Rückruf status. Dieser Parameter kann einer der folgenden Werte oder einer der anderen Systemfehlercodes sein.
| Wert | Bedeutung |
|---|---|
|
Der Aufrufer verfügte nicht über ausreichende Berechtigungen zum Öffnen eines Zielthreads. |
|
Die asynchrone Sitzung wurde durch einen Aufruf der CloseThreadWaitChainSession-Funktion abgebrochen. |
|
Der NodeInfoArray-Puffer ist nicht groß genug, um alle Knoten in der Wartekette zu enthalten. Der NodeCount-Parameter enthält die Anzahl der Knoten in der Kette. Die zurückgegebene Wartekette ist weiterhin gültig. |
|
Der angegebene Thread konnte nicht gefunden werden. |
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Die Anzahl der Knoten überschreitet WCT_MAX_NODE_COUNT. Die zurückgegebene Wartekette ist weiterhin gültig. |
NodeCount
Die Anzahl der abgerufenen Knoten bis zu WCT_MAX_NODE_COUNT. Wenn das Array nicht alle Knoten der Wartekette enthalten kann, schlägt die Funktion fehl, CallbackStatus ist ERROR_MORE_DATA, und dieser Parameter empfängt die Anzahl der Arrayelemente, die erforderlich sind, um alle Knoten zu enthalten.
NodeInfoArray
Ein Array von WAITCHAIN_NODE_INFO Strukturen, das die Wartekette empfängt.
IsCycle
Wenn die Funktion einen Deadlock erkennt, wird diese Variable auf TRUE festgelegt. Andernfalls ist er auf FALSE festgelegt.
Rückgabewert
Keine
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wct.h |