IDebugDataSpaces3::SearchVirtual-Methode (dbgeng.h)

Artikel
02/26/2024

Die SearchVirtual-Methode durchsucht den virtuellen Arbeitsspeicher des Ziels nach einem angegebenen Bytemuster.

Syntax

HRESULT SearchVirtual(
  [in]  ULONG64  Offset,
  [in]  ULONG64  Length,
  [in]  PVOID    Pattern,
  [in]  ULONG    PatternSize,
  [in]  ULONG    PatternGranularity,
  [out] PULONG64 MatchOffset
);

Parameter

[in] Offset

Gibt den Speicherort im virtuellen Adressraum des Ziels an, um mit der Suche nach dem Muster zu beginnen.

[in] Length

Gibt an, wie weit nach dem Muster gesucht werden soll. Eine erfolgreiche Übereinstimmung erfordert, dass das gesamte Muster gefunden wird, bevor Längenbytes untersucht wurden.

[in] Pattern

Gibt das muster an, nach dem gesucht werden soll.

[in] PatternSize

Gibt die Größe des Musters in Bytes an. Dies muss ein Vielfaches der Granularität des Musters sein.

[in] PatternGranularity

Gibt die Granularität des Musters an. Für eine erfolgreiche Übereinstimmung muss das Muster ein Vielfaches dieses Werts nach dem Startstandort auftreten.

[out] MatchOffset

Empfängt den Speicherort im virtuellen Adressraum des Ziels des Musters, wenn er gefunden wurde.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
HRESULT_FROM_NT(STATUS_NO_MORE_ENTRIES)	Nach der Untersuchung von Längenbytes wurde das Muster nicht gefunden.

Hinweise

Diese Methode durchsucht den virtuellen Arbeitsspeicher des Ziels auf das erste Vorkommen des Musters, das vollständig in den Längenbytes des Speichers des Ziels enthalten ist, ab dem Speicherort Offset.

PatternGranularity kann verwendet werden, um die Ausrichtung der Übereinstimmung relativ zu Offset sicherzustellen. Beispielsweise kann ein Wert von 0x4 verwendet werden, um eine Ausrichtung auf ein DWORD zu erfordern. Ein Wert von 0x1 kann verwendet werden, damit das Muster an einer beliebigen Stelle gestartet werden kann.

Weitere Optionen, einschließlich der Möglichkeit, die Suche auf schreibbaren Arbeitsspeicher zu beschränken, finden Sie unter SearchVirtual2.