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


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

Извлекает индексы для указанного файла PDB, DBG или образа, который будет использоваться для хранения файла. Сочетание этих значений однозначно идентифицирует файл на сервере символов. Их можно использовать при вызове функции SymFindFileInPath для поиска файла в хранилище символов.

Синтаксис

BOOL IMAGEAPI SymSrvGetFileIndexes(
  [in]            PCSTR  File,
  [out]           GUID   *Id,
  [out]           PDWORD Val1,
  [out, optional] PDWORD Val2,
  [in]            DWORD  Flags
);

Параметры

[in] File

Имя файла.

[out] Id

Первый из трех идентифицирующие параметры.

[out] Val1

Второй из трех идентифицирующие параметры.

[out, optional] Val2

Третий из трех идентифицирующие параметры.

[in] Flags

Этот параметр зарезервирован для использования в будущем.

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

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

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

Комментарии

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

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

Требования

Требование Значение
Целевая платформа Windows
Header dbghelp.h
Библиотека Dbghelp.lib
DLL Dbghelp.dll
Распространяемые компоненты DbgHelp.dll 6.3 или более поздней версии

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

Функции DbgHelp