Función ImageRvaToVa (dbghelp.h)

Artículo
02/26/2024

Busca una dirección virtual relativa (RVA) dentro del encabezado de imagen de un archivo asignado como un archivo y devuelve la dirección virtual del byte correspondiente en el archivo.

Sintaxis

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

Parámetros

[in] NtHeaders

Puntero a una estructura de IMAGE_NT_HEADERS . Esta estructura se puede obtener llamando a la función ImageNtHeader .

[in] Base

Dirección base de una imagen que se asigna a la memoria a través de una llamada a la función MapViewOfFile .

[in] Rva

Dirección virtual relativa que se va a ubicar.

[in, optional] LastRvaSection

Puntero a una estructura de IMAGE_SECTION_HEADER que especifica la última sección de RVA. Se trata de un parámetro opcional. Cuando se especifica, apunta a una variable que contiene el último valor de sección usado para la imagen especificada para traducir una RVA a un VA.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es la dirección virtual en el archivo asignado.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para recuperar información de error extendida, llame a GetLastError.

Comentarios

La función ImageRvaToVa busca una RVA dentro del encabezado de imagen de un archivo asignado como un archivo y devuelve la dirección virtual del byte correspondiente en el archivo.

Todas las funciones DbgHelp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.