Функция SymSrvGetFileIndexString (dbghelp.h)
Извлекает строку индекса для указанного файла PDB, DBG или файла образа.
Синтаксис
BOOL IMAGEAPI SymSrvGetFileIndexString(
[in] HANDLE hProcess,
[in, optional] PCSTR SrvPath,
[in] PCSTR File,
[out] PSTR Index,
[in] size_t Size,
[in] DWORD Flags
);
Параметры
[in] hProcess
Дескриптор процесса. Этот дескриптор должен быть ранее передан в функцию SymInitialize .
[in, optional] SrvPath
Путь к серверу символов.
[in] File
Имя файла.
[out] Index
Указатель на буфер, получающий строку индекса.
[in] Size
Размер буфера индекса в символах.
[in] Flags
Этот параметр зарезервирован для использования в будущем.
Возвращаемое значение
Если функция выполнена успешно, возвращается значение TRUE.
Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.
Комментарии
Эта функция не предназначена для общего использования. Эти служебные программы для управления файлами в хранилищах сервера символов могут использовать эту функцию для прогнозирования относительного пути, который сервер символов будет искать для файла. Он используется srctool.exe для фактического заполнения хранилищ сервера символов.
Все функции DbgHelp, такие как эта, являются однопоточными. Таким образом, вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.
Чтобы вызвать версию юникода этой функции, определите DBGHELP_TRANSLATE_TCHAR.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Библиотека | DbgHelp.lib |
| DLL | DbgHelp.dll |
| Распространяемые компоненты | DbgHelp.dll 6.3 или более поздней версии |