Método IDebugBreakpoint2::GetOffsetExpressionWide (dbgeng.h)

O método GetOffsetExpressionWide retorna a cadeia de caracteres de expressão que é avaliada para o local que dispara um ponto de interrupção.

Sintaxe

HRESULT GetOffsetExpressionWide(
  [out, optional] PWSTR  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG ExpressionSize
);

Parâmetros

[out, optional] Buffer

A cadeia de caracteres de expressão que é avaliada como 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)