IDebugSymbols3::GetSymbolEntryString-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetSymbolEntryString Methode gibt Zeichenfolgeninformationen für das angegebene Symbol zurück.

Syntax

HRESULT GetSymbolEntryString(
  [in]            PDEBUG_MODULE_AND_ID Id,
  [in]            ULONG                Which,
  [out, optional] PSTR                 Buffer,
  [in]            ULONG                BufferSize,
  [out, optional] PULONG               StringSize
);

Parameter

[in] Id

Gibt die Symbole an, deren Speicherbereiche angefordert werden. Die DEBUG_MODULE_AND_ID Struktur enthält das Modul, das das Symbol und die Symbol-ID des Symbols innerhalb des Moduls enthält.

[in] Which

Gibt den Index der gewünschten Zeichenfolge an. Dies ist häufig Null, da die meisten Symbole nur eine Zeichenfolge (deren Name) enthalten. Einige Symbole können jedoch mehrere Zeichenfolgen enthalten, z. B. Anmerkungssymbole.

[out, optional] Buffer

Empfängt den Namen des Symbols. Wenn Puffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

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

[out, optional] StringSize

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

Rückgabewert

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

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Weitere Informationen zu Symbolen finden Sie unter Symbole.

Anforderungen

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

Siehe auch

GetSymbolEntriesByName

GetSymbolEntriesByOffset-

IDebugSymbols3

Freigeben über