IDebugDataSpaces::SearchVirtual-Methode (dbgeng.h)

Artikel
02/06/2025

Die SearchVirtual-Methode durchsucht den virtuellen Speicher 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 Adressbereich des Ziels an, um mit der Suche nach dem Muster zu beginnen.

[in] Length

Gibt an, wie weit nach dem Muster gesucht werden soll. Für eine erfolgreiche Übereinstimmung muss das gesamte Muster gefunden werden, bevor Länge Bytes untersucht wurden.

[in] Pattern

Gibt das Muster an, nach dem gesucht werden soll.

[in] PatternSize

Gibt die Größe in Byte des Musters 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 nach dem Startspeicherort ein Vielfaches dieses Werts sein.

[out] MatchOffset

Empfängt den Speicherort im virtuellen Adressraum des Ziels des Musters, wenn es 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 Länge Bytes wurde das Muster nicht gefunden.

Bemerkungen

Diese Methode durchsucht den virtuellen Speicher des Ziels nach dem ersten Vorkommen, vorbehaltlich der Granularität, des Musters, das vollständig in der Length Bytes des Speichers des Ziels ab dem Speicherort Offsetenthalten ist.

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 überall beginnen kann.

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