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


Метод IDebugControl3::GetTextMacro (dbgeng.h)

Метод GetTextMacro возвращает значение псевдонима с фиксированным именем.

Синтаксис

HRESULT GetTextMacro(
  [in]            ULONG  Slot,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG MacroSize
);

Параметры

[in] Slot

Указывает номер псевдонима фиксированного имени. Слот может принимать значения 0, 1, ..., 9, которые представляют псевдонимы с фиксированным именем $u 0, $u 1, ..., $u 9.

[out, optional] Buffer

Получает значение псевдонима, заданного параметром Slot. Если параметр Buffer имеет значение NULL, эта информация не возвращается.

[in] BufferSize

Указывает размер буфера буфера буфера (в символах).

[out, optional] MacroSize

Получает размер (в символах) значения псевдонима.

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

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

Код возврата Описание
S_OK
Метод выполнен успешно.

Комментарии

Перед выполнением команд или вычислением выражений подсистема отладчика заменит псевдоним, заданный параметром Slot , значением псевдонима (возвращенного буферу буфера ).

Общие сведения о псевдонимах, используемых подсистемой отладчика, см. в разделе Использование псевдонимов. Дополнительные сведения об использовании псевдонимов с API обработчика отладчика см. в разделе Взаимодействие с обработчиком.

Требования

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

См. также раздел

GetNumberTextReplacements

GetTextReplacement

IDebugControl

IDebugControl2

IDebugControl3

SetTextMacro

r (регистры)