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 |
---|---|
|
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) |