IDebugSymbols::GetNextSymbolMatch-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetNextSymbolMatch- -Methode gibt das nächste Symbol in einer Symbolsuche zurück.

Syntax

HRESULT GetNextSymbolMatch(
  [in]            ULONG64  Handle,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   MatchSize,
  [out, optional] PULONG64 Offset
);

Parameter

[in] Handle

Gibt das von StartSymbolMatch zurückgegebene Handle an, wenn die Suche initialisiert wurde.

[out, optional] Buffer

Empfängt den Namen des Symbols. Wenn Puffer-NULL-ist, wird dasselbe Symbol erneut zurückgegeben, wenn eine dieser Methoden das nächste Mal aufgerufen wird (mit demselben Handle); Dies kann verwendet werden, um die Größe des Namens des Symbols zu bestimmen.

[in] BufferSize

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

[out, optional] MatchSize

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

[out, optional] Offset

Empfängt den Speicherort im virtuellen Adressraum des Ziels des Symbols. Wenn Offset-NULL-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 Größe des Puffers war für den Namen des Symbols zu klein, oder Puffer-NULL-.
E_NOINTERFACE	Es wurden keine weiteren Symbole gefunden, die dem Muster entsprechen.

Bemerkungen

Die Suche muss zuerst von StartSymbolMatchinitialisiert werden. Sobald alle gewünschten Symbole gefunden wurden, kann EndSymbolMatch- verwendet werden, um die Ressourcen freizugeben, die das Modul für die Suche enthält.

Weitere Informationen zu Symbolen finden Sie unter Symbole.