VerifierEnumerateResource 函式 (avrfsdk.h)

發行項
03/05/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 會列舉堆積配置，包括堆積元數據區塊。