IDebugSymbolGroup2::GetSymbolName-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetSymbolName Methode gibt den Namen eines Symbols in einer Symbolgruppe zurück.

Syntax

HRESULT GetSymbolName(
  [in]            ULONG  Index,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG NameSize
);

Parameter

[in] Index

Der Index des Symbols, dessen Name Sie verwenden möchten. Der Index eines Symbols ist eine Identifikationsnummer. Der Index reicht von Null bis zur Anzahl der Symbole in der Symbolgruppe minus 1.

[out, optional] Buffer

Der Symbolname. Wenn Puffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Die Größe des Puffers, auf den Buffer verweist. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] NameSize

Die Größe des Symbolnamens. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn NameSize-NULL-ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Der Name des Symbols passte jedoch nicht in den Puffer, auf den der parameter Buffer verweist, sodass ein abgeschnittener Name zurückgegeben wurde.

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Bemerkungen

Weitere Informationen zu Symbolgruppen finden Sie unter Bereiche und Symbolgruppen.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Siehe auch

GetNumberSymbols-

IDebugSymbolGroup

IDebugSymbolGroup2

Freigeben über