IDebugSymbols3::StartSymbolMatch-Methode (dbgeng.h)

Artikel
02/26/2024

Die StartSymbolMatch-Methode initialisiert eine Suche nach Symbolen, deren Namen einem bestimmten Muster entsprechen.

Syntax

HRESULT StartSymbolMatch(
  [in]  PCSTR    Pattern,
  [out] PULONG64 Handle
);

Parameter

[in] Pattern

Gibt das Muster an, nach dem gesucht werden soll. Die Suche gibt alle Symbole zurück, deren Namen diesem Muster entsprechen. Ausführliche Informationen zur Syntax des Musters finden Sie unter Symbolsyntax und Symbolabgleich und Zeichenfolgenplatzhaltersyntax.

[out] Handle

Empfängt das Handle, das die Suche identifiziert. Dieses Handle kann an GetNextSymbolMatch und EndSymbolMatch übergeben werden.

Rückgabewert

Diese Methode gibt möglicherweise auch andere Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_NOINTERFACE	Das angegebene Modul wurde nicht gefunden.

Hinweise

Diese Methode initialisiert eine Symbolsuche. Die Ergebnisse der Suche können durch wiederholte Aufrufe von GetNextSymbolMatch abgerufen werden. Wenn alle gewünschten Ergebnisse gefunden wurden, verwenden Sie EndSymbolMatch , um Ressourcen freizugeben, die die Engine für die Suche enthält.

Weitere Informationen zu Symbolen finden Sie unter Symbole.