Funzione VerifierEnumerateResource (avrfsdk.h)

Articolo
08/22/2023

Enumera le risorse del sistema operativo da usare eseguendo il debug e gli strumenti di supporto.

Sintassi

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

Parametri

Process

Handle per il processo in cui vengono enumerate le risorse.

Quando il parametro ResourceType è AvrfResrouceHeapAllocation, l'handle deve essere aperto con i diritti di accesso PROCESS_VM_READ e PROCESS_QUERY_INFORMATION.

Se ResourceType è AvrfResrouceHeapAllocation e il parametro Flags contiene AVRF_ENUM_RESOURCES_FLAGS_SUSPEND, è necessario usare anche il flag PROCESS_SUSPEND_RESUME.

Flags

Se ResourceType è AvrfResourceHandleTrace, non vengono definiti flag e il valore per il parametro Flags deve essere 0.

Se il parametro ResourceType è AvrfResourceHeapAllocation, il parametro Flags può essere 0 o una combinazione dei valori seguenti.

Valore	Significato
AVRF_ENUM_RESOURCES_FLAGS_DONT_RESOLVE_TRACES	Il backtraces dello stack delle allocazioni dell'heap, quando presente, non viene copiato nella matrice ReturnAddresses. Ciò può velocizzare il processo di enumerazione.
AVRF_ENUM_RESOURCES_FLAGS_SUSPEND	Il processo viene sospeso prima dell'esecuzione dell'enumerazione dell'heap. Ciò riduce al minimo la possibilità che la modifica dell'heap possa influire sull'enumerazione.

ResourceType

Questo parametro può essere uno dei valori seguenti:

Valore	Significato
AvrfResourceHandleTrace	L'API enumera le ultime operazioni salvate negli handle dalla tabella handle del processo corrente.
AvrfResourceHeapAllocation	L'API enumera l'allocazione dell'heap, inclusi i blocchi di metadati heap.

ResourceCallback

Funzione definita dall'applicazione richiamata dall'API.

Il prototipo è agnostico verso il tipo di risorsa da enumerare. L'uso passerà un prototipo adatto per il tipo di enumerazione eseguita

EnumerationContext

Puntatore specifico dell'applicazione passato alla funzione di callback.

Valore restituito

Questa funzione restituisce uno dei codici di errore di sistema.

Commenti

Questa funzione non ha alcuna libreria di importazione associata. È necessario usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Verifier.dll.