Freigeben über


ImageRvaToVa-Funktion (dbghelp.h)

Sucht eine relative virtuelle Adresse (RVA) im Imageheader einer Datei, die als Datei zugeordnet ist, und gibt die virtuelle Adresse des entsprechenden Bytes in der Datei zurück.

Syntax

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

Parameter

[in] NtHeaders

Ein Zeiger auf eine IMAGE_NT_HEADERS-Struktur . Diese Struktur kann durch Aufrufen der ImageNtHeader-Funktion abgerufen werden.

[in] Base

Die Basisadresse eines Bilds, das durch einen Aufruf der MapViewOfFile-Funktion dem Arbeitsspeicher zugeordnet wird.

[in] Rva

Die relative virtuelle Adresse, die zu finden ist.

[in, optional] LastRvaSection

Ein Zeiger auf eine IMAGE_SECTION_HEADER-Struktur , die den letzten RVA-Abschnitt angibt. Dies ist ein optionaler Parameter. Wenn angegeben, zeigt sie auf eine Variable, die den letzten Abschnittswert enthält, der für das angegebene Bild verwendet wird, um eine RVA in eine VA zu übersetzen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die virtuelle Adresse in der zugeordneten Datei.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Die ImageRvaToVa-Funktion sucht ein RVA im Bildheader einer Datei, die als Datei zugeordnet ist, und gibt die virtuelle Adresse des entsprechenden Bytes in der Datei zurück.

Alle DbgHelp-Funktionen, z. B. diese, sind singlethreaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, müssen Sie alle an diese Funktion gerichteten gleichzeitigen Aufrufe mehrerer Threads synchronisieren.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile dbghelp.h
Bibliothek Dbghelp.lib
DLL Dbghelp.dll
Verteilbare Komponente DbgHelp.dll 5.1 oder höher

Weitere Informationen

DbgHelp-Funktionen

IMAGE_NT_HEADERS

IMAGE_SECTION_HEADER

ImageNtHeader

MapViewOfFile