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

Artigo
02/23/2024

O método GetBreakpointParameters retorna os parâmetros de um ou mais pontos de interrupção.

Sintaxe

HRESULT GetBreakpointParameters(
  [in]           ULONG                        Count,
  [in, optional] PULONG                       Ids,
  [in]           ULONG                        Start,
  [out]          PDEBUG_BREAKPOINT_PARAMETERS Params
);

Parâmetros

[in] Count

Especifica o número de pontos de interrupção cujos parâmetros estão sendo solicitados.

[in, optional] Ids

Especifica uma matriz que contém as IDs dos pontos de interrupção cujos parâmetros estão sendo solicitados. O número de itens nessa matriz deve ser igual ao valor especificado em Count. Se Ids for NULL, Start será usado.

[in] Start

Especifica o índice inicial dos pontos de interrupção cujos parâmetros estão sendo solicitados. Os parâmetros para pontos de interrupção com índices Iniciar até Iniciar mais Contagem menos um serão retornados. Start será usado somente se Ids for NULL.

[out] Params

Recebe os parâmetros para os pontos de interrupção especificados. O tamanho dessa matriz é igual ao valor de Count. Para obter detalhes sobre a estrutura retornada, consulte DEBUG_BREAKPOINT_PARAMETERS.

Retornar valor

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

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O método foi bem-sucedido. No entanto, os parâmetros para alguns dos pontos de interrupção não foram retornados. Os parâmetros que não foram retornados têm seu campo de ID definido como DEBUG_ANY_ID.

Comentários

Alguns dos parâmetros podem não ser retornados. Isso acontece se não foi possível encontrar um ponto de interrupção ou se um ponto de interrupção for privado (consulte GetFlags).