IDebugSymbols::GetNextSymbolMatch-Methode (dbgeng.h)

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

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 Handle an, das von StartSymbolMatch zurückgegeben wurde, als die Suche initialisiert wurde.

[out, optional] Buffer

Empfängt den Namen des Symbols. Wenn BufferNULL ist, wird das gleiche Symbol beim nächsten Aufruf einer dieser Methoden (mit demselben Handle) erneut zurückgegeben. dies kann verwendet werden, um die Größe des Namens des Symbols zu bestimmen.

[in] BufferSize

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

[out, optional] MatchSize

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

[out, optional] Offset

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

Hinweise

Die Suche muss zuerst von StartSymbolMatch initialisiert werden. Nachdem alle gewünschten Symbole gefunden wurden, kann EndSymbolMatch verwendet werden, um die Ressourcen freizugeben, die die Engine für die Suche enthält.

Weitere Informationen zu Symbolen finden Sie unter Symbole.

Anforderungen

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

Weitere Informationen

EndSymbolMatch

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

StartSymbolMatch