IDebugClient::D ispatchCallbacks-Methode (dbgeng.h)

Artikel
02/06/2025

Mit der DispatchCallbacks Methode kann das Debuggermodul den aktuellen Thread für Rückrufe verwenden.

Syntax

HRESULT DispatchCallbacks(
  [in] ULONG Timeout
);

Parameter

[in] Timeout

Gibt an, wie viele Millisekunden gewartet werden sollen, bevor diese Methode zurückgegeben wird. Wenn Timeout- unendlich ist, wird diese Methode erst zurückgegeben, wenn ExitDispatch- aufgerufen wird oder ein Fehler auftritt.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich (ExitDispatch wurde verwendet).
S_FALSE	Timeout Millisekunden verstrichen.

Bemerkungen

Diese Methode gibt zurück, wenn Timeout Millisekunden verstrichen ist, ExitDispatch- aufgerufen wird oder ein Fehler auftritt.

Fast alle Clientmethoden müssen aus dem Thread aufgerufen werden, in dem der Client erstellt wurde; Rückrufobjekte, die beim Client registriert sind, werden auch von diesem Thread aufgerufen. Wenn DispatchCallbacks- aufgerufen wird, kann das Modul den aktuellen Thread verwenden, um Rückrufaufrufe durchzuführen.

Clientthreads sollten diese Methode nach Möglichkeit aufrufen, damit die Rückrufe aufgerufen werden können, es sei denn, der Thread war derselbe Thread, der zum Starten der Debuggersitzung verwendet wurde. In diesem Fall werden die Rückrufe aufgerufen, wenn WaitForEvent- aufgerufen wird.

Weitere Informationen zu Rückrufen finden Sie unter Rückrufe.