Metodo IDebugClient5::D ispatchCallbacks (dbgeng.h)

Articolo
02/06/2025

Il metodo DispatchCallbacks consente al motore del debugger di usare il thread corrente per i callback.

Sintassi

HRESULT DispatchCallbacks(
  [in] ULONG Timeout
);

Parametri

[in] Timeout

Specifica il numero di millisecondi di attesa prima che venga restituito questo metodo. Se timeout è INFINITE, questo metodo non restituisce finché non viene chiamato ExitDispatch o si verifica un errore.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo ( è stato usatoExitDispatch).
S_FALSE	timeout millisecondi trascorsi.

Osservazioni

Questo metodo restituisce quando è trascorso timeout millisecondi, viene chiamato exitDispatch o si verifica un errore.

Quasi tutti i metodi client devono essere chiamati dal thread in cui è stato creato il client; oggetti di callback registrati con il client vengono chiamati anche da questo thread. Quando DispatchCallbacks viene chiamato il motore può usare il thread corrente per effettuare chiamate di callback.

I thread client devono chiamare questo metodo quando possibile per consentire la chiamata dei callback, a meno che il thread non sia lo stesso thread usato per avviare la sessione del debugger, nel qual caso i callback vengono chiamati quando viene chiamato WaitForEvent.

Per altre informazioni sui callback, vedere callback.