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

Статья
11/20/2024

Перечисляет все вхождения указанного файла в указанном дереве каталогов.

Синтаксис

BOOL IMAGEAPI EnumDirTreeW(
  [in, optional]  HANDLE                 hProcess,
  [in]            PCWSTR                 RootPath,
  [in]            PCWSTR                 InputPathName,
  [out, optional] PWSTR                  OutputPathBuffer,
  [in, optional]  PENUMDIRTREE_CALLBACKW cb,
  [in, optional]  PVOID                  data
);

Параметры

[in, optional] hProcess

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

[in] RootPath

Путь, в котором функция должна начать поиск файла.

[in] InputPathName

Имя найденного файла. Можно указать частичный путь.

[out, optional] OutputPathBuffer

Указатель на буфер, получающий полный путь к файлу. Если функция завершается ошибкой или не находит соответствующий файл, этот буфер по-прежнему будет содержать последний полный путь, найденный.

Этот параметр является необязательным и может быть null.

[in, optional] cb

Определяемая приложением функция обратного вызова или NULL. Дополнительные сведения см. в разделе EnumDirTreeProc.

[in, optional] data

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

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

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

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

Замечания

Поиск можно отменить, если зарегистрировать функцию обратного вызова SymRegisterCallbackProc6 4. Для каждой операции с файлами EnumDirTree вызывает эту функцию обратного вызова с CBA_DEFERRED_SYMBOL_LOAD_CANCEL. Если функция обратного вызова возвращает TRUE, EnumDirTree отменяет поиск.

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

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

Заметка

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

Требования

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

См. также

функций DbgHelp

EnumDirTreeProc

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