Fonction VerifierEnumerateResource (avrfsdk.h)

Article
08/22/2023

Énumère les ressources du système d’exploitation à utiliser par les outils de débogage et de support.

Syntaxe

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

Paramètres

Process

Handle du processus dans lequel les ressources sont énumérées.

Lorsque le paramètre ResourceType est AvrfResrouceHeapAllocation, le handle doit être ouvert avec les droits d’accès PROCESS_VM_READ et PROCESS_QUERY_INFORMATION.

Si ResourceType est AvrfResrouceHeapAllocation et que le paramètre Flags contient AVRF_ENUM_RESOURCES_FLAGS_SUSPEND, l’indicateur PROCESS_SUSPEND_RESUME doit également être utilisé.

Flags

Si ResourceType est AvrfResourceHandleTrace, aucun indicateur n’est défini et la valeur du paramètre Flags doit être 0.

Si le paramètre ResourceType est AvrfResourceHeapAllocation, le paramètre Flags peut être 0 ou une combinaison des valeurs suivantes.

Valeur	Signification
AVRF_ENUM_RESOURCES_FLAGS_DONT_RESOLVE_TRACES	Les backtraces de pile des allocations de tas, lorsqu’elles sont présentes, ne sont pas copiées sur le tableau ReturnAddresses. Cela peut accélérer le processus d’énumération.
AVRF_ENUM_RESOURCES_FLAGS_SUSPEND	Le processus est suspendu avant l’exécution de l’énumération des allocations de tas. Cela réduit le risque que la modification du tas affecte l’énumération.

ResourceType

Ce paramètre peut être l’une des valeurs suivantes :

Valeur	Signification
AvrfResourceHandleTrace	L’API énumère les dernières opérations récemment enregistrées sur les handles de la table handle du processus actuel.
AvrfResourceHeapAllocation	L’API énumère l’allocation de tas, y compris les blocs de métadonnées de tas.

ResourceCallback

Fonction définie par l’application appelée par l’API.

Le prototype est indépendant du type de ressource énumérée. L’utilisation passera un prototype adapté au type d’énumération en cours d’exécution

EnumerationContext

Pointeur spécifique à l’application qui est passé à la fonction de rappel.

Valeur retournée

Cette fonction retourne l’un des codes d’erreur système.

Remarques

Cette fonction n’a pas de bibliothèque d’importation associée. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir un lien dynamique vers Verifier.dll.