VerifierEnumerateResource-Funktion (avrfsdk.h)

Artikel
03/01/2024

Listet Betriebssystemressourcen auf, die von Debug- und Supporttools verwendet werden können.

Syntax

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

Parameter

Process

Ein Handle für den Prozess, in dem Ressourcen aufgelistet werden.

Wenn der ResourceType-Parameter AvrfResrouceHeapAllocation ist, muss das Handle mit den PROCESS_VM_READ und PROCESS_QUERY_INFORMATION Zugriffsrechten geöffnet werden.

Wenn ResourceType AvrfResrouceHeapAllocation ist und der Flags-Parameter AVRF_ENUM_RESOURCES_FLAGS_SUSPEND enthält, muss auch das flag PROCESS_SUSPEND_RESUME verwendet werden.

Flags

Wenn ResourceType avrfResourceHandleTrace ist, werden keine Flags definiert, und der Wert für den Flags-Parameter muss 0 sein.

Wenn der ResourceType-Parameter AvrfResourceHeapAllocation ist, kann der Flags-Parameter 0 oder eine Kombination der folgenden Werte sein.

Wert	Bedeutung
AVRF_ENUM_RESOURCES_FLAGS_DONT_RESOLVE_TRACES	Die Stapelrückverfolgungen der Heapzuordnungen werden, sofern vorhanden, nicht über das ReturnAddresses-Array kopiert. Dies kann den Enumerationsprozess beschleunigen.
AVRF_ENUM_RESOURCES_FLAGS_SUSPEND	Der Prozess wird angehalten, bevor die Heapzuordnungsaufzählung ausgeführt wird. Dadurch wird das Risiko minimiert, dass sich die Änderung des Heaps auf die Enumeration auswirken kann.

ResourceType

Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
AvrfResourceHandleTrace	Die API listet die letzten zuletzt gespeicherten Vorgänge für die Handles aus der Handletabelle des aktuellen Prozesses auf.
AvrfResourceHeapAllocation	Die API listet die Heapzuordnung auf, einschließlich Heapmetadatenblöcken.

ResourceCallback

Eine anwendungsdefinierte Funktion, die von der API aufgerufen wird.

Der Prototyp ist unabhängig von der Art der Ressource, die aufgelistet wird. Bei der Verwendung wird ein Prototyp übergeben, der für den Typ der ausgeführten Enumeration geeignet ist.

EnumerationContext

Ein anwendungsspezifischer Zeiger, der an die Rückruffunktion zurückgegeben wird.

Rückgabewert

Diese Funktion gibt einen der Systemfehlercodes zurück.

Hinweise

Diese Funktion verfügt über keine zugeordnete Importbibliothek. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch mit Verifier.dll zu verknüpfen.