IDebugSymbolGroup2::GetSymbolName-Methode (dbgeng.h)

  • Artikel

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 Namen Sie benötigen. 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 BufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Die Größe des Puffers, auf den Puffer zeigt. Diese Größe enthält den Leerraum für das "\0"-Endzeichen.

[out, optional] NameSize

Die Größe des Symbolnamens. Diese Größe enthält den Leerraum für das "\0"-Endzeichen. Wenn NameSizeNULL 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 Buffer-Parameter verweist, sodass ein abgeschnittener Name zurückgegeben wurde.
 

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

Hinweise

Weitere Informationen zu Symbolgruppen finden Sie unter Bereiche und Symbolgruppen.

Anforderungen

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

Weitere Informationen

GetNumberSymbols

IDebugSymbolGroup

IDebugSymbolGroup2