Função VerifierEnumerateResource (avrfsdk.h)

Artigo
03/09/2023

Enumera recursos do sistema operacional para uso por meio de ferramentas de depuração e suporte.

Sintaxe

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

Parâmetros

Process

Um identificador para o processo no qual os recursos estão sendo enumerados.

Quando o parâmetro ResourceType é AvrfResrouceHeapAllocation, o identificador deve ser aberto com os direitos de acesso PROCESS_VM_READ e PROCESS_QUERY_INFORMATION.

Se ResourceType for AvrfResrouceHeapAllocation e o parâmetro Flags contiver AVRF_ENUM_RESOURCES_FLAGS_SUSPEND, o sinalizador PROCESS_SUSPEND_RESUME também deverá ser usado.

Flags

Se ResourceType for AvrfResourceHandleTrace, nenhum sinalizador será definido e o valor do parâmetro Flags deverá ser 0.

Se o parâmetro ResourceType for AvrfResourceHeapAllocation, o parâmetro Flags poderá ser 0 ou uma combinação dos valores a seguir.

Valor	Significado
AVRF_ENUM_RESOURCES_FLAGS_DONT_RESOLVE_TRACES	Os backtraces de pilha das alocações de heap, quando presentes, não são copiados pela matriz ReturnAddresses. Isso pode acelerar o processo de enumeração.
AVRF_ENUM_RESOURCES_FLAGS_SUSPEND	O processo é suspenso antes que a enumeração de alocações de heap seja executada. Isso minimiza a chance de que a alteração do heap possa afetar a enumeração.

ResourceType

Esse parâmetro pode usar um dos valores a seguir:

Valor	Significado
AvrfResourceHandleTrace	A API enumera as últimas operações salvas recentemente nos identificadores da tabela de identificadores do processo atual.
AvrfResourceHeapAllocation	A API enumera a alocação de heap, incluindo blocos de metadados de heap.

ResourceCallback

Uma função definida pelo aplicativo que é invocada pela API.

O protótipo é independente em relação ao tipo de recurso que está sendo enumerado. O uso passará um protótipo adequado para o tipo de enumeração que está sendo executada

EnumerationContext

Um ponteiro específico do aplicativo que é passado de volta para a função de retorno de chamada.

Retornar valor

Essa função retorna um dos códigos de erro do sistema.

Comentários

Essa função não tem biblioteca de importação associada. Você deve usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Verifier.dll.