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

Статья
11/20/2024

Перечисляет все исходные файлы в процессе.

Синтаксис

BOOL IMAGEAPI SymEnumSourceFilesW(
  [in]           HANDLE                         hProcess,
  [in]           ULONG64                        ModBase,
  [in, optional] PCWSTR                         Mask,
  [in]           PSYM_ENUMSOURCEFILES_CALLBACKW cbSrcFiles,
  [in, optional] PVOID                          UserContext
);

Параметры

[in] hProcess

Дескриптор процесса. Этот дескриптор должен быть передан в функцию SymInitialize.

[in] ModBase

Базовый адрес модуля. Если это значение равно нулю и Маска содержит восклицательный знак (!), функция выглядит по модулям. Если это значение равно нулю и Маска не содержит восклицательный знак, функция использует область, установленную функцией SymSetContext.

[in, optional] Mask

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

Если этот параметр NULL, функция перечисляет все файлы.

[in] cbSrcFiles

Указатель на функцию обратного вызова SymEnumSourceFilesProc , которая получает сведения о исходном файле.

[in, optional] UserContext

Определяемое пользователем значение, передаваемое в функцию обратного вызова, или NULL. Этот параметр обычно используется приложением для передачи указателя на структуру данных, которая предоставляет контекст для функции обратного вызова.

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

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

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

Замечания

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

Заметка

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

Требования

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

См. также

функций DbgHelp

SymEnumSourceFilesProc

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