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

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

  • Статья

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

Примечание Эта функция работает с DBG-файлами, а не с PDB-файлами.
 
Эта функция была заменена функцией UpdateDebugInfoFileEx . Используйте UpdateDebugInfoFileEx , чтобы проверить значение контрольной суммы.

Синтаксис

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

Параметры

[in] ImageFileName

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

[in] SymbolPath

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

[out] DebugFilePath

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

[in] NtHeaders

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

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

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

Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.

Комментарии

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

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

Требования

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

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

IMAGE_NT_HEADERS

Функции ImageHlp

UpdateDebugInfoFileEx