IDebugSymbols::GetNameByOffset-Methode (dbgeng.h)

Artikel
02/23/2024

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 Symbols an, dessen Name angefordert wird. Offset muss die Basisposition des Symbols nicht angeben. Es muss nur ein Speicherort innerhalb der Speicherbelegung des Symbols angegeben werden.

[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!Standard). Wenn NameBufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] NameBufferSize

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

[out, optional] NameSize

Empfängt die Größe des Symbolnamens in Zeichen. Diese Größe enthält den Leerraum für das "\0"-Endzeichen. Wenn NameSizeNULL ist, werden diese Informationen nicht zurückgegeben.

[out, optional] Displacement

Empfängt die Differenz zwischen dem Wert von Offset und der Basisposition des Symbols. Wenn die VerschiebungNULL ist, werden diese Informationen nicht zurückgegeben.

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