verifierEnumerateResource 函数 (avrfsdk.h)

项目
02/28/2024

枚举供调试和支持工具使用的操作系统资源。

语法

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 枚举堆分配，包括堆元数据块。