функция обратного вызова PENUMDIRTREE_CALLBACKW (dbghelp.h)

Статья
11/20/2024

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

Типы PENUMDIRTREE_CALLBACK и PENUMDIRTREE_CALLBACKW определяют указатель на эту функцию обратного вызова. EnumDirTreeProc является заполнителем для имени определяемой приложением функции.

Синтаксис

PENUMDIRTREE_CALLBACKW PenumdirtreeCallbackw;

BOOL PenumdirtreeCallbackw(
  [in]           PCWSTR FilePath,
  [in, optional] PVOID CallerData
)
{...}

Параметры

[in] FilePath

Указатель на буфер, получающий полный путь найденного файла.

[in, optional] CallerData

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

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

Чтобы продолжить перечисление, функция обратного вызова должна возвращать FALSE.

Чтобы остановить перечисление, функция обратного вызова должна возвращать TRUE.

Замечания

Заметка

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

Требования

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

См. также

функций DbgHelp

EnumDirTree

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