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


Функция GetFieldData (wdbgexts.h)

Функция GetFieldData возвращает значение элемента в структуре.

Синтаксис

ULONG GetFieldData(
  [in]  ULONG64 TypeAddress,
  [in]  LPCSTR  Type,
  [in]  LPCSTR  Field,
  [in]  ULONG   OutSize,
  [out] PVOID   pOutValue
);

Параметры

[in] TypeAddress

Указывает адрес структуры в памяти целевого объекта.

[in] Type

Указывает имя типа структуры. Это можно указать с помощью имени модуля, например mymodule!mystruct.

[in] Field

Указывает имя элемента в структуре, значение которого будет возвращено. Вложенные атрибуты можно указать с помощью пути, разделенного точками, например myfield.mysubfield.

Если размер структуры, на которую указывает TypeAddress , меньше 8 байт, поле может иметь значение NULL; в этом случае вся структура копируется в pOutValue.

[in] OutSize

Указывает размер буфера pOutValue (в байтах).

Если OutSize меньше размера возвращаемого значения, выводится сообщение об ошибке и возникает исключение; Если исключение обрабатывается или игнорируется, возвращаемое значение равно нулю. В этом случае данные за пределами буфера, на который ссылается pOutValue, могут быть перезаписаны.

[out] pOutValue

Получает значение элемента. Или значение типа , если поле имеет значение NULL.

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

Если вызов функции заканчивается удачно, возвращается нулевое значение. В противном случае возвращаемое значение представляет собой код ошибки IG_DUMP_SYMBOL_INFO.

Требования

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