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

Artigo
02/06/2025

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	de ponto de interrupção de software
DEBUG_BREAKPOINT_DATA	do 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.

Valor de retorno

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 Type não foi reconhecido.

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

Observações

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.

Observação Mesmo que 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.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

pontos de interrupção

IDebugBreakpoint

IDebugControl

IDebugControl2

IDebugControl3

RemoveBreakpoint

usando pontos de interrupção

Partilhar via