IDebugSymbols3::GetOffsetByNameWide-Methode (dbgeng.h)
Die GetOffsetByNameWide-Methode gibt den Speicherort eines durch den Namen identifizierten Symbols zurück.
Syntax
HRESULT GetOffsetByNameWide(
[in] PCWSTR 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 |
|---|---|
|
Die Methode war erfolgreich. |
|
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. |
|
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | dbgeng.h (einschließlich Dbgeng.h) |