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

Artigo
02/26/2024

O método SetEventCallbacks registra um objeto de retorno de chamada de evento com esse cliente.

Sintaxe

HRESULT SetEventCallbacks(
  [in, optional] PDEBUG_EVENT_CALLBACKS Callbacks
);

Parâmetros

[in, optional] Callbacks

Especifica o ponteiro de interface para o objeto de retorno de chamada de evento a ser registrado com esse cliente.

Retornar valor

Dependendo da implementação do método IDebugEventCallbacks::GetInterestMask no objeto especificado por Callbacks, outros valores podem ser retornados, conforme descrito na seção Comentários.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Se o valor de Callbacks não for NULL, o método IDebugEventCallbacks::GetInterestMask será chamado. Se o valor retornado não for S_OK, SetEventCallbacks e SetEventCallbacksWide não terão efeito e retornarão esse valor.

Cada cliente pode ter no máximo um objeto IDebugEventCallbacks ou IDebugEventCallbacksWide registrado com ele para receber eventos.

A interface IDebugEventCallbacks estende a interface COM IUnknown. Quando SetEventCallbacks e SetEventCallbacksWide são bem-sucedidos, eles chamam o método IUnknown::AddRef do objeto especificado por Callbacks. O método IUnknown::Release desse objeto será chamado na próxima vez que SetEventCallbacks ou SetEventCallbacksWide for chamado nesse cliente ou quando esse cliente for excluído.

Para obter mais informações sobre retornos de chamada, consulte Retornos de chamada.