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

Статья
08/07/2023

Метод 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 обработчика отладчика см. в разделе Взаимодействие с обработчиком.