Método IDebugControl3::AddBreakpoint (dbgeng.h)

Artigo
02/23/2024

O método AddBreakpoint cria um novo ponto de interrupção para o destino atual.

Sintaxe

HRESULT AddBreakpoint(
  [in]  ULONG             Type,
  [in]  ULONG             DesiredId,
  [out] PDEBUG_BREAKPOINT *Bp
);

Parâmetros

[in] Type

Especifica o tipo de ponto de interrupção do novo ponto de interrupção. Esse pode ser um dos seguintes valores:

Valor	Descrição
DEBUG_BREAKPOINT_CODE	ponto de interrupção de software
DEBUG_BREAKPOINT_DATA	ponto de interrupção do processador

[in] DesiredId

Especifica a ID desejada do novo ponto de interrupção. Se for DEBUG_ANY_ID, o mecanismo escolherá uma ID não utilizado.

[out] Bp

Recebe um ponteiro de interface para o novo ponto de interrupção.

Retornar valor

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	O ponto de interrupção não pôde ser criado com a ID desejada ou o valor de Tipo não foi reconhecido.

Esse método também pode retornar outros valores de erro. Consulte Valores retornados para obter mais detalhes.

Comentários

Se DesiredId não estiver DEBUG_ANY_ID e outro ponto de interrupção já usar a ID DesiredId, esses métodos falharão.

Os pontos de interrupção são criados vazios e desabilitados. Consulte Usando pontos de interrupção para obter detalhes sobre como configurar e habilitar o ponto de interrupção.

O cliente é salvo como o adder do novo ponto de interrupção. Consulte GetAdder.

Nota Embora IDebugBreakpoint estenda a interface COM IUnknown, o tempo de vida do ponto de interrupção não é controlado usando a interface IUnknown . Em vez disso, o ponto de interrupção é excluído depois que RemoveBreakpoint é chamado.