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

  • Artigo

Os métodos GetOffsetExpression retornam a cadeia de caracteres de expressão que é avaliada para o local que dispara um ponto de interrupção.

Sintaxe

HRESULT GetOffsetExpression(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG ExpressionSize
);

Parâmetros

[out, optional] Buffer

A cadeia de caracteres de expressão que é avaliada para o local no destino que dispara o ponto de interrupção. 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] ExpressionSize

O tamanho, em caracteres, da cadeia de caracteres de expressão. Se ExpressionSize 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 expressão e, portanto, a cadeia de caracteres 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 expressão é avaliada sempre que um módulo é carregado ou descarregado. Se o depurador não puder avaliar a expressão (por exemplo, se a expressão contiver um símbolo que não pode ser interpretado), o ponto de interrupção será sinalizado como adiado. (Para obter mais informações sobre pontos de interrupção adiados, consulte Controlando sinalizadores e parâmetros de ponto de interrupção.)

O método GetParameters também retorna o tamanho da cadeia de caracteres de expressão que especifica o local que dispara o ponto de interrupção ExpressionSize.

Para obter mais informações sobre como usar pontos de interrupção, consulte Usando pontos de interrupção.

Requisitos

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