Compartir a través de


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

El método SetEventCallbacks registra un objeto de devoluciones 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 Devoluciones de llamada, se pueden devolver otros valores, tal como se describe en la sección Comentarios.

Código devuelto Descripción
S_OK
El método se realizó correctamente.

Observaciones

Si el valor de callbacks 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 objeto IDebugEventCallbacksWide registrado con él para recibir eventos .

La interfaz IDebugEventCallbacks amplía la interfaz COM IUnknown. Cuando setEventCallbacks y setEventCallbacksWide se realizan correctamente, llaman al método IUnknown::AddRef del objeto especificado por Callbacks. El método IUnknown::Release de este objeto se llamará la próxima vez SetEventCallbacks o se llama a SetEventCallbacksWide en este cliente o cuando se elimina este cliente.

Para obtener más información sobre las devoluciones de llamada, consulte Devoluciones de llamada.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de dbgeng.h (include Dbgeng.h)

Consulte también

GetEventCallbacks

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

IDebugEventCallbacks