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

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.

Valor retornado

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 do 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.

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

   
Plataforma de Destino Desktop
Cabeçalho dbgeng.h (include Dbgeng.h)

Confira também

Pontos de Interrupção

IDebugBreakpoint

Idebugcontrol

IDebugControl2

IDebugControl3

RemoveBreakpoint

Usando pontos de interrupção