Freigeben über


IDebugSymbols2::GetNameByOffset-Methode (dbgeng.h)

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 des Symbols im virtuellen Adressraum des Ziels 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 Platz für das "\0"-Endzeichen.

[out, optional] NameSize

Empfängt die Größe des Symbolnamens in Zeichen. Diese Größe enthält den Platz 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 VerschiebungNULL 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 aufzunehmen, sodass er abgeschnitten wurde.
E_FAIL
An der angegebenen Position konnte kein Symbol gefunden werden.

Hinweise

Weitere Informationen zu Symbolen und Symbolnamen finden Sie unter Symbole.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dbgeng.h (einschließlich Dbgeng.h)

Weitere Informationen

GetNearNameByOffset

GetOffsetByName

IDebugSymbols

IDebugSymbols2

IDebugSymbols3