Функция SymGetSourceFile (dbghelp.h)
Извлекает указанный исходный файл с исходного сервера.
Синтаксис
BOOL IMAGEAPI SymGetSourceFile(
[in] HANDLE hProcess,
[in] ULONG64 Base,
[in, optional] PCSTR Params,
[in] PCSTR FileSpec,
[out] PSTR FilePath,
[in] DWORD Size
);
Параметры
[in] hProcess
Дескриптор процесса. Этот дескриптор должен быть ранее передан в функцию SymInitialize .
[in] Base
Базовый адрес модуля.
[in, optional] Params
Этот параметр не используется.
[in] FileSpec
Имя исходного файла.
[out] FilePath
Указатель на буфер, который получает полный путь к исходному файлу.
[in] Size
Размер буфера FilePath в символах.
Возвращаемое значение
Если функция выполнена успешно, возвращается значение TRUE.
Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.
Комментарии
Чтобы указать, какой каталог получает исходные файлы, используйте функцию SymSetHomeDirectory .
Все функции DbgHelp, такие как эта, являются однопоточными. Таким образом, вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.
Чтобы вызвать версию юникода этой функции, определите DBGHELP_TRANSLATE_TCHAR.
Требования
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Библиотека | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Распространяемые компоненты | DbgHelp.dll 6.2 или более поздней версии |