IDebugSymbols3::GetNextSymbolMatchWide-Methode (dbgeng.h)
Die GetNextSymbolMatchWide-Methode gibt das nächste Symbol zurück, das in einer Symbolsuche gefunden wurde.
Syntax
HRESULT GetNextSymbolMatchWide(
[in] ULONG64 Handle,
[out, optional] PWSTR 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 Leerraum für das "\0"-Endzeichen.
[out, optional] MatchSize
Empfängt die Größe des Namens des Symbols in Zeichen. Diese Größe enthält den Leerraum 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 gibt möglicherweise auch andere Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .
Rückgabecode | BESCHREIBUNG |
---|---|
|
Die Methode war erfolgreich. |
|
Die Größe des Puffers war für den Namen des Symbols zu klein, oder Buffer war NULL. |
|
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 (dbgeng.h einschließen) |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für