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

Artikel
02/26/2024

Mit der DispatchCallbacks-Methode kann die Debugger-Engine den aktuellen Thread für Rückrufe verwenden.

Syntax

HRESULT DispatchCallbacks(
  [in] ULONG Timeout
);

Parameter

[in] Timeout

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

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

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

Hinweise

Diese Methode gibt zurück, wenn Timeout millisekunden abgelaufen 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 aus diesem Thread aufgerufen. Wenn DispatchCallbacks aufgerufen wird, kann die Engine den aktuellen Thread verwenden, um Rückrufaufrufe zu tätigen.

Clientthreads sollten diese Methode nach Möglichkeit aufrufen, um den Aufruf der Rückrufe zu ermöglichen, 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.