Поделиться через

Метод IDebugBreakpoint2::GetOffsetExpression (dbgeng.h)

  • Статья

Методы GetOffsetExpression возвращают строку выражения, результатом которого является расположение, активирующее точку останова.

Синтаксис

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

Параметры

[out, optional] Buffer

Строка выражения, результатом которого является расположение на целевом объекте, который активирует точку останова. Если параметр Buffer имеет значение NULL, эти сведения не возвращаются.

[in] BufferSize

Размер (в символах) буфера, на который указывает Buffer .

[out, optional] ExpressionSize

Размер строки выражения в символах. Если параметр ExpressionSize имеет значение NULL, эти сведения не возвращаются.

Возвращаемое значение

Код возврата Описание
S_OK
 Метод выполнен успешно.
S_FALSE
 Метод был успешным, но буфер был недостаточно велик для хранения строки выражения, поэтому строка была усечена в соответствии с размером.
 

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения.

Комментарии

Выражение вычисляется каждый раз при загрузке или выгрузке модуля. Если отладчик не может вычислить выражение (например, если выражение содержит символ, который не может быть интерпретирован), точка останова помечается как отложенная. (Дополнительные сведения об отложенных точках останова см. в разделе Управление флагами и параметрами точек останова.)

Метод GetParameters также возвращает размер строки выражения, указывающей расположение, которое активирует точку останова , ExpressionSize.

Дополнительные сведения об использовании точек останова см. в разделе Использование точек останова.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)