Метод IDebugSymbolGroup::OutputAsType (dbgeng.h)

Статья
02/23/2024

Метод OutputAsType изменяет тип символа в группе символов. Запись символа обновляется для представления нового типа.

Синтаксис

HRESULT OutputAsType(
  [in] ULONG Index,
  [in] PCSTR Type
);

Параметры

[in] Index

Индекс записи в этой группе символов. Индекс символа — это идентификационный номер. Индекс в диапазоне от нуля до числа символов в группе символов минус один.

[in] Type

Имя типа нужного символа. Если имя начинается с восклицательного знака (!), оно рассматривается как расширение. Дополнительные сведения об использовании расширения в качестве типа см. в разделе Примечания.

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

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

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

Поскольку дочерние элементы нового типа записи могут отличаться от дочерних элементов старого типа записи, метод OutputAsType удаляет все дочерние элементы записи из группы символов. Дочерние элементы можно добавить обратно с помощью метода ExpandSymbol .

Если Type является расширением, адрес символа передается расширению. Каждая строка выходных данных расширения становится дочерним символом указанного символа. Эти дочерние символы являются текстом, и вы не можете управлять ими каким-либо образом. Например, если переменная имеет имя @$teb, можно изменить ее тип на !teb.

Дополнительные сведения о группах символов см. в разделе Области и группы символов.