Método IDebugClient3::SetEventCallbacks (dbgeng.h)
El método SetEventCallbacks registra un objeto de devolución de llamada de eventos con este cliente.
Sintaxis
HRESULT SetEventCallbacks(
[in, optional] PDEBUG_EVENT_CALLBACKS Callbacks
);
Parámetros
[in, optional] Callbacks
Especifica el puntero de interfaz al objeto de devoluciones de llamada de eventos que se va a registrar con este cliente.
Valor devuelto
Dependiendo de la implementación del método IDebugEventCallbacks::GetInterestMask en el objeto especificado por Callbacks, se pueden devolver otros valores, como se describe en la sección Comentarios.
| Código devuelto | Descripción |
|---|---|
|
Método realizado correctamente. |
Comentarios
Si el valor de Devoluciones de llamada no es NULL, se llama al método IDebugEventCallbacks::GetInterestMask . Si el valor devuelto no es S_OK, SetEventCallbacks y SetEventCallbacksWide no tienen ningún efecto y devuelven este valor.
Cada cliente puede tener como máximo un objeto IDebugEventCallbacks o IDebugEventCallbacksWide registrado con él para recibir eventos.
La interfaz IDebugEventCallbacks extiende la interfaz COM IUnknown. Cuando SetEventCallbacks y SetEventCallbacksWide se realizan correctamente, llaman al método IUnknown::AddRef del objeto especificado por Devoluciones de llamada. El método IUnknown::Release de este objeto se llamará la próxima vez que se llame a SetEventCallbacks o SetEventCallbacksWide en este cliente, o cuando se elimine este cliente.
Para obtener más información sobre las devoluciones de llamada, consulte Devoluciones de llamada.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | dbgeng.h (include Dbgeng.h) |