Функция SymSrvGetFileIndexInfoW (dbghelp.h)

Статья
11/20/2024

Извлекает сведения об индексе для указанного PDB, DBG или файла образа.

Синтаксис

BOOL IMAGEAPI SymSrvGetFileIndexInfoW(
  [in]  PCWSTR              File,
  [out] PSYMSRV_INDEX_INFOW Info,
  [in]  DWORD               Flags
);

Параметры

[in] File

Имя файла.

[out] Info

Структура SYMSRV_INDEX_INFO, которая получает сведения об индексе.

[in] Flags

Этот параметр зарезервирован для дальнейшего использования.

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

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

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

Замечания

Эта функция не используется для общего использования. Те, кто записывает служебные программы для управления файлами в хранилищах символов, могут использовать эту функцию для прогнозирования относительного пути, по которому сервер символов будет искать файл. Он используется srctool.exe для заполнения хранилищ серверов символов. Он также может использоваться для тех, кто ищет параметры для канала функции SymFindFileInPath.

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

Чтобы вызвать версию этой функции Юникода, определите DBGHELP_TRANSLATE_TCHAR.

Заметка

Заголовок dbghelp.h определяет SymSrvGetFileIndexInfo как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	dbghelp.h
библиотеки	Dbghelp.lib
DLL	Dbghelp.dll
распространяемый	DbgHelp.dll 6.6 или более поздней версии

См. также

функций DbgHelp

SYMSRV_INDEX_INFO

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