Metodo IDebugClient::D ispatchCallbacks (dbgeng.h)

Articolo
08/07/2023

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

Sintassi

HRESULT DispatchCallbacks(
  [in] ULONG Timeout
);

Parametri

[in] Timeout

Specifica il numero di millisecondi da attendere prima che questo metodo venga restituito. Se Timeout è INFINITE, questo metodo non restituirà finché ExitDispatch non viene chiamato o si verifica un errore.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, 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 i millisecondi di Timeout sono trascorsi, ExitDispatch viene chiamato 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 ogni volta che è possibile consentire di chiamare i callback, a meno che il thread non fosse 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.