Metodo IDebugClient5::SetEventCallbacksWide (dbgeng.h)
Il metodo SetEventCallbacksWide registra un oggetto callback di eventi con questo client.
Sintassi
HRESULT SetEventCallbacksWide(
[in] PDEBUG_EVENT_CALLBACKS_WIDE Callbacks
);
Parametri
[in] 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 |
|---|---|
|
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 IDebugEventCallbacksWide 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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | dbgeng.h (include Dbgeng.h) |