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

Функция VerifierEnumerateResource (avrfsdk.h)

  • Статья

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

Синтаксис

ULONG VerifierEnumerateResource(
  HANDLE                           Process,
  ULONG                            Flags,
  ULONG                            ResourceType,
  AVRF_RESOURCE_ENUMERATE_CALLBACK ResourceCallback,
  PVOID                            EnumerationContext
);

Параметры

Process

Дескриптор процесса, в котором перечисляются ресурсы.

Если параметр ResourceType имеет значение AvrfResrouceHeapAllocation, дескриптор должен быть открыт с PROCESS_VM_READ и PROCESS_QUERY_INFORMATION прав доступа.

Если параметр ResourceType имеет значение AvrfResrouceHeapAllocation, а параметр Flags содержит AVRF_ENUM_RESOURCES_FLAGS_SUSPEND, необходимо также использовать флаг PROCESS_SUSPEND_RESUME.

Flags

Если resourceType имеет значение AvrfResourceHandleTrace, флаги не определяются, а значение параметра Flags должно быть равно 0.

Если параметр ResourceType имеет значение AvrfResourceHeapAllocation, параметр Flags может иметь значение 0 или сочетание следующих значений.

Значение Значение
AVRF_ENUM_RESOURCES_FLAGS_DONT_RESOLVE_TRACES
 Обратные трассировки стека выделений кучи, если они имеются, не копируются по массиву ReturnAddresses. Это может ускорить процесс перечисления.
AVRF_ENUM_RESOURCES_FLAGS_SUSPEND
 Процесс приостанавливается перед выполнением перечисления выделений кучи. Это сводит к минимуму вероятность того, что изменение кучи может повлиять на перечисление.

ResourceType

Этот параметр может иметь одно из следующих значений:

Значение Значение
AvrfResourceHandleTrace
 API перечисляет последние недавно сохраненные операции с дескрипторами из таблицы дескрипторов текущего процесса.
AvrfResourceHeapAllocation
 API перечисляет выделение кучи, включая блоки метаданных кучи.

ResourceCallback

Определяемая приложением функция, вызываемая API.

Прототип не зависит от типа перечисляемого ресурса. При использовании будет передаваться прототип, подходящий для типа выполняемого перечисления.

EnumerationContext

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

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

Эта функция возвращает один из кодов системных ошибок.

Комментарии

У этой функции нет связанной библиотеки импорта. Для динамического связывания с Verifier.dll необходимо использовать функции LoadLibrary и GetProcAddress .

Примеры

См . раздел Использование перечисления ресурсов.

Требования

Требование Значение
Целевая платформа Windows
Header avrfsdk.h
DLL Verifier.dll

См. также раздел

AVRF_HANDLEOPERATION_ENUMERATE_CALLBACK

AVRF_HEAPALLOCATION_ENUMERATE_CALLBACK

AVRF_RESOURCE_ENUMERATE_CALLBACK

Перечисление ресурсов