IDebugSymbols3::GetOffsetByName-Methode (dbgeng.h)

Artikel
02/06/2025

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 qualifiziert werden (z. B. mymodule!main).

[out] Offset

Empfängt den Speicherort im Speicheradressraum des Ziels der Basis der Speicherzuweisung 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 wurde kein Symbol mit dem angegebenen Namen gefunden.

Bemerkungen

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). Um ein Symbol mithilfe des Musterabgleichs zu finden, 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 sie eine Übereinstimmung findet. Dies kann sehr 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 Symbol- und Symbolnamen finden Sie unter Symbole.