Función VerifierEnumerateResource (avrfsdk.h)

Artículo
03/09/2023

Enumera los recursos del sistema operativo para usarlos mediante la depuración y las herramientas de soporte técnico.

Sintaxis

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

Parámetros

Process

Identificador del proceso en el que se enumeran los recursos.

Cuando el parámetro ResourceType es AvrfResrouceHeapAllocation, el identificador debe abrirse con los derechos de acceso PROCESS_VM_READ y PROCESS_QUERY_INFORMATION.

Si ResourceType es AvrfResrouceHeapAllocation y el parámetro Flags contiene AVRF_ENUM_RESOURCES_FLAGS_SUSPEND, también se debe usar la marca PROCESS_SUSPEND_RESUME.

Flags

Si ResourceType es AvrfResourceHandleTrace, no se definen marcas y el valor del parámetro Flags debe ser 0.

Si el parámetro ResourceType es AvrfResourceHeapAllocation, el parámetro Flags puede ser 0 o una combinación de los valores siguientes.

Valor	Significado
AVRF_ENUM_RESOURCES_FLAGS_DONT_RESOLVE_TRACES	Los retrocesos de la pila de las asignaciones del montón, cuando están presentes, no se copian en la matriz ReturnAddresses. Esto puede acelerar el proceso de enumeración.
AVRF_ENUM_RESOURCES_FLAGS_SUSPEND	El proceso se suspende antes de que se ejecute la enumeración de asignaciones del montón. Esto minimiza la posibilidad de que cambiar el montón pueda afectar a la enumeración.

ResourceType

Este parámetro puede ser uno de los valores siguientes:

Valor	Significado
AvrfResourceHandleTrace	La API enumera las últimas operaciones guardadas recientemente en los identificadores de la tabla handle del proceso actual.
AvrfResourceHeapAllocation	La API enumera la asignación del montón, incluidos los bloques de metadatos del montón.

ResourceCallback

Función definida por la aplicación invocada por la API.

El prototipo es independiente del tipo de recurso que se está enumerando. El uso pasará un prototipo adecuado para el tipo de enumeración que se realiza.

EnumerationContext

Puntero específico de la aplicación que se devuelve a la función de devolución de llamada.

Valor devuelto

Esta función devuelve uno de los códigos de error del sistema.

Comentarios

Esta función no tiene ninguna biblioteca de importación asociada. Debe usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Verifier.dll.