IDebugSymbols2::StartSymbolMatch-Methode (dbgeng.h)

Artikel
02/06/2025

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 Zeichenfolgen-Wildcardsyntax.

[out] Handle

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

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.
E_NOINTERFACE	Das angegebene Modul wurde nicht gefunden.

Bemerkungen

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

Weitere Informationen zu Symbolen finden Sie unter Symbole.