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

Метод GetOffsetExpressionWide возвращает строку выражения, которая вычисляет расположение, которое активирует точку останова.

Синтаксис

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

Параметры

[out, optional] Buffer

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

[in] BufferSize

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

[out, optional] ExpressionSize

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

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

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

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

Замечания

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

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

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

Требования

Требование Ценность
целевая платформа Настольный
заголовка dbgeng.h (include Dbgeng.h)