Método IDebugBreakpoint::GetCommand (dbgeng.h)

  • Artigo

O método GetCommand retorna a cadeia de caracteres de comando executada quando um ponto de interrupção é disparado.

Sintaxe

HRESULT GetCommand(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG CommandSize
);

Parâmetros

[out, optional] Buffer

A cadeia de caracteres de comando executada quando o ponto de interrupção é disparado. Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

O tamanho, em caracteres, do buffer para o qual o Buffer aponta.

[out, optional] CommandSize

O tamanho da cadeia de caracteres de comando. Se CommandSize for NULL, essas informações não serão retornadas.

Retornar valor

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
S_FALSE
 O método foi bem-sucedido, mas o buffer não era grande o suficiente para manter a cadeia de caracteres de comando e, portanto, a cadeia de caracteres de comando foi truncada para caber.
 

Esse método também pode retornar valores de erro. Para obter mais informações, consulte Valores retornados.

Comentários

A cadeia de caracteres de comando é uma lista de comandos de depurador separados por ponto e vírgula. Esses comandos são executados sempre que o ponto de interrupção é disparado. Os comandos são executados antes que o mecanismo informe quaisquer retornos de chamada de evento que o ponto de interrupção tenha sido disparado.

O método GetParameters também retorna o tamanho do comando do ponto de interrupção, CommandSize.

Para obter mais informações sobre propriedades de ponto de interrupção, consulte Controlando sinalizadores e parâmetros de ponto de interrupção.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)