Функция SymEnumSourceFiles (dbghelp.h)
Перечисляет все исходные файлы в процессе.
Синтаксис
BOOL IMAGEAPI SymEnumSourceFiles(
[in] HANDLE hProcess,
[in] ULONG64 ModBase,
[in, optional] PCSTR Mask,
[in] PSYM_ENUMSOURCEFILES_CALLBACK cbSrcFiles,
[in, optional] PVOID UserContext
);
Параметры
[in] hProcess
Дескриптор процесса. Этот дескриптор должен быть ранее передан в функцию SymInitialize .
[in] ModBase
Базовый адрес модуля. Если это значение равно нулю и Маска содержит восклицательный знак (!), функция выполняет поиск по модулям. Если это значение равно нулю и маска не содержит восклицательный знак, функция использует область, установленный функцией SymSetContext.
[in, optional] Mask
Выражение с подстановочными знаками, указывающее имена перечисляемых исходных файлов. Чтобы указать имя модуля, используйте ! Синтаксис mod .
Если этот параметр имеет значение NULL, функция перечисляет все файлы.
[in] cbSrcFiles
Указатель на функцию обратного вызова SymEnumSourceFilesProc , которая получает сведения об исходном файле.
[in, optional] UserContext
Определяемое пользователем значение, передаваемое в функцию обратного вызова, или NULL. Этот параметр обычно используется приложением для передачи указателя на структуру данных, которая предоставляет контекст для функции обратного вызова.
Возвращаемое значение
Если функция выполнена успешно, возвращается значение TRUE.
Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.
Комментарии
Все функции DbgHelp, такие как эта, являются однопоточными. Таким образом, вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Библиотека | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Распространяемые компоненты | DbgHelp.dll 6.2 или более поздней версии |