Método IDebugClient::SetEventCallbacks (dbgeng.h)
El método SetEventCallbacks registra un objeto de devolución de llamada de evento 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
Según 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 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 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 Callbacks. 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 (incluir Dbgeng.h) |