Método IDebugClient5::SetEventCallbacks (dbgeng.h)

Artículo
02/23/2024

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
S_OK	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.