IDebugSymbols3::GetNameByOffset-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetNameByOffset--Methode gibt den Namen des Symbols an der angegebenen Position im virtuellen Adressraum des Ziels zurück.

Syntax

HRESULT GetNameByOffset(
  [in]            ULONG64  Offset,
  [out, optional] PSTR     NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 Displacement
);

Parameter

[in] Offset

Gibt den Speicherort im virtuellen Adressraum des Ziels des Symbols an, dessen Name angefordert wird. Offset- muss nicht die Basisposition des Symbols angeben; sie muss nur einen Speicherort innerhalb der Speicherzuweisung des Symbols angeben.

[out, optional] NameBuffer

Empfängt den Namen des Symbols. Der Name wird durch das Modul qualifiziert, zu dem das Symbol gehört (z. B. mymodule!main). Wenn NameBuffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] NameBufferSize

Gibt die Größe in Zeichen des Puffers NameBuffer-an. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] NameSize

Empfängt die Größe in Zeichen des Namens des Symbols. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn NameSize-NULL-ist, werden diese Informationen nicht zurückgegeben.

[out, optional] Displacement

Empfängt den Unterschied zwischen dem Wert von Offset und der Basisposition des Symbols. Wenn Verdrängungs-NULL-ist, werden diese Informationen nicht zurückgegeben.

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 Puffer war jedoch nicht groß genug, um den Namen des Symbols zu halten, sodass er abgeschnitten wurde.
E_FAIL	Es wurde kein Symbol an der angegebenen Position gefunden.