Metodo IDebugClient5::D ispatchCallbacks (dbgeng.h)

Articolo
02/23/2024

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 restituirà 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 (ExitDispatch è stato usato).
S_FALSE	Timeout millisecondi trascorsi.

Commenti

Questo metodo restituisce quando sono trascorsi i millisecondi di timeout , viene chiamato ExitDispatch o si verifica un errore.

Quasi tutti i metodi client devono essere chiamati dal thread in cui è stato creato il client; anche gli oggetti callback registrati con il client vengono chiamati 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.