Função ImageRvaToVa (dbghelp.h)

Artigo
02/26/2024

Localiza um RVA (endereço virtual relativo) dentro do cabeçalho de imagem de um arquivo mapeado como um arquivo e retorna o endereço virtual do byte correspondente no arquivo.

Sintaxe

PVOID IMAGEAPI ImageRvaToVa(
  [in]           PIMAGE_NT_HEADERS     NtHeaders,
  [in]           PVOID                 Base,
  [in]           ULONG                 Rva,
  [in, optional] PIMAGE_SECTION_HEADER *LastRvaSection
);

Parâmetros

[in] NtHeaders

Um ponteiro para uma estrutura IMAGE_NT_HEADERS . Essa estrutura pode ser obtida chamando a função ImageNtHeader .

[in] Base

O endereço base de uma imagem mapeada na memória por meio de uma chamada para a função MapViewOfFile .

[in] Rva

O endereço virtual relativo a ser localizado.

[in, optional] LastRvaSection

Um ponteiro para uma estrutura IMAGE_SECTION_HEADER que especifica a última seção RVA. Esse é um parâmetro opcional. Quando especificado, ele aponta para uma variável que contém o último valor de seção usado para a imagem especificada para converter um RVA em um VA.

Retornar valor

Se a função for bem-sucedida, o valor retornado será o endereço virtual no arquivo mapeado.

Se a função falhar, o valor retornado será NULL. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

A função ImageRvaToVa localiza um RVA dentro do cabeçalho de imagem de um arquivo mapeado como um arquivo e retorna o endereço virtual do byte correspondente no arquivo.

Todas as funções DbgHelp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.