Функция UpdateDebugInfoFileEx (imagehlp.h)

  • Статья

Использует указанные расширенные сведения для обновления соответствующих полей в файле символов.

Примечание Эта функция работает с DBG-файлами, а не с PDB-файлами.
 

Синтаксис

BOOL IMAGEAPI UpdateDebugInfoFileEx(
  [in]  PCSTR               ImageFileName,
  [in]  PCSTR               SymbolPath,
  [out] PSTR                DebugFilePath,
  [in]  PIMAGE_NT_HEADERS32 NtHeaders,
  [in]  DWORD               OldCheckSum
);

Параметры

[in] ImageFileName

Имя изображения, которое теперь устарело по отношению к его файлу символов.

[in] SymbolPath

Путь к файлу символов.

[out] DebugFilePath

Указатель на буфер, получающий имя обновленного файла символов.

[in] NtHeaders

Указатель на структуру IMAGE_NT_HEADERS , указывающую сведения о новых заголовках.

[in] OldCheckSum

Исходное значение контрольной суммы. Если это значение не соответствует контрольной сумме, которая присутствует на сопоставленном изображении, флаги в файле символов содержат IMAGE_SEPARATE_DEBUG_MISMATCH, а последнее значение ошибки устанавливается в ERROR_INVALID_DATA.

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

Если функция выполнена успешно, возвращается значение TRUE.

Если функция завершается сбоем, возвращается значение FALSE.

Комментарии

Функция UpdateDebugInfoFileEx принимает сведения, хранящиеся в структуре IMAGE_NT_HEADERS , и обновляет соответствующие поля в файле символов. При изменении файла изображения эту функцию следует вызывать для синхронизации чисел. В частности, при каждом изменении контрольной суммы изображения файл символов следует обновлять в соответствии с указанными значениями.

Все функции ImageHlp, такие как эта, являются однопоточными. Таким образом, вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header imagehlp.h
Библиотека Imagehlp.lib
DLL Imagehlp.dll

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

IMAGE_NT_HEADERS

Функции ImageHlp