IDebugSymbols2::GetOffsetByName-Methode (dbgeng.h)

Artikel
02/26/2024

Die GetOffsetByName-Methode gibt den Speicherort eines durch den Namen identifizierten Symbols zurück.

Syntax

HRESULT GetOffsetByName(
  [in]  PCSTR    Symbol,
  [out] PULONG64 Offset
);

Parameter

[in] Symbol

Gibt den Namen des zu suchenden Symbols an. Der Name kann durch einen Modulnamen (z. B. mymodule!Standard) qualifiziert werden.

[out] Offset

Empfängt den Speicherort im Speicheradressraum des Ziels der Basis der Speicherzuordnung des Symbols.

Rückgabewert

Diese Methode kann auch andere Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Der Name Symbol war jedoch nicht eindeutig, und es wurden mehrere Symbole mit diesem Namen gefunden. Eines dieser Symbole wurde willkürlich ausgewählt und zurückgegeben.
E_FAIL	Es konnte kein Symbol mit dem angegebenen Namen gefunden werden.

Hinweise

Wenn der Name Symbol nicht eindeutig ist und GetOffsetByName mehrere Symbole mit diesem Namen findet, wird die Mehrdeutigkeit willkürlich aufgelöst. In diesem Fall wird der Wert S_FALSE zurückgegeben. StartSymbolMatch kann verwendet werden, um eine Suche zu initiieren, um zu bestimmen, welches Ergebnis das gewünschte Ergebnis ist.

GetNameByOffset unterstützt keinen Musterabgleich (z. B. Wildcards). Verwenden Sie StartSymbolMatch, um ein Symbol mithilfe des Musterabgleichs zu finden.

Wenn der Modulname für das Symbol bekannt ist, ist es am besten, den Symbolnamen mit dem Modulnamen zu qualifizieren. Andernfalls sucht die Engine die Symbole nach allen Modulen, bis sie eine Übereinstimmung findet. Dies kann lange dauern, wenn die Symboldateien für viele Module geladen werden müssen. Wenn der Symbolname mit einem Modulnamen qualifiziert ist, durchsucht das Modul nur die Symbole für dieses Modul.

Weitere Informationen zu Symbolen und Symbolnamen finden Sie unter Symbole.