Metodo IDebugClient4::SetEventCallbacks (dbgeng.h)

Articolo
02/27/2024

Il metodo SetEventCallbacks registra un oggetto callback di eventi con questo client.

Sintassi

HRESULT SetEventCallbacks(
  [in, optional] PDEBUG_EVENT_CALLBACKS Callbacks
);

Parametri

[in, optional] Callbacks

Specifica il puntatore di interfaccia all'oggetto callback eventi da registrare con questo client.

Valore restituito

A seconda dell'implementazione del metodo IDebugEventCallbacks::GetInterestMask nell'oggetto specificato dai callback, è possibile restituire altri valori, come descritto nella sezione Osservazioni.

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

Se il valore di Callbacks non è NULL, viene chiamato il metodo IDebugEventCallbacks::GetInterestMask . Se il valore restituito non è S_OK, SetEventCallbacks e SetEventCallbacksWide non hanno alcun effetto e restituiscono questo valore.

Ogni client può avere al massimo un oggetto IDebugEventCallbacks o IDebugEventCallbacksWide registrato per la ricezione di eventi.

L'interfaccia IDebugEventCallbacks estende l'interfaccia COM IUnknown. Quando SetEventCallbacks e SetEventCallbacksWide hanno esito positivo, chiamano il metodo IUnknown::AddRef dell'oggetto specificato dai callback. Il metodo IUnknown::Release di questo oggetto verrà chiamato alla successiva chiamata a SetEventCallbacks o SetEventCallbacksWide su questo client o quando questo client viene eliminato.

Per altre informazioni sui callback, vedere Callback.