IDebugSymbols::GetOffsetByName-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetOffsetByName-Methode gibt die Position eines Symbols zurück, das durch den Namen identifiziert wird.

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 Speicherbelegung des Symbols.

Rückgabewert

Diese Methode gibt möglicherweise auch andere Fehlerwerte zurück. 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 beliebig 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). Um ein Symbol mithilfe des Musterabgleichs zu suchen, verwenden Sie StartSymbolMatch.

Wenn der Modulname für das Symbol bekannt ist, empfiehlt es sich, den Symbolnamen mit dem Modulnamen zu qualifizieren. Andernfalls durchsucht die Engine die Symbole für alle Module, bis eine Übereinstimmung gefunden wird. dies kann lange dauern, wenn die Symboldateien für viele Module geladen werden müssen. Wenn der Symbolname mit einem Modulnamen qualifiziert ist, durchsucht die Engine nur die Symbole für dieses Modul.

Weitere Informationen zu Symbolen und Symbolnamen finden Sie unter Symbole.