Compartilhar via


Função ImageRvaToVa (dbghelp.h)

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.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho dbghelp.h
Biblioteca Dbghelp.lib
DLL Dbghelp.dll
Redistribuível DbgHelp.dll 5.1 ou posterior

Confira também

Funções DbgHelp

IMAGE_NT_HEADERS

IMAGE_SECTION_HEADER

ImageNtHeader

Mapviewoffile