IDebugDataSpaces::SearchVirtual-Methode (dbgeng.h)

Artikel
02/26/2024

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 Adressraum des Ziels an, an dem mit der Suche nach dem Muster begonnen werden soll.

[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 Byte 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 Startort 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 Speicher des Ziels nach dem ersten Vorkommen des Musters, das vollständig in den Längenbytes des Zielspeichers enthalten ist, und zwar ab dem Standortoffset.

PatternGranularity kann verwendet werden, um die Ausrichtung der Übereinstimmung relativ zu Offset sicherzustellen. Beispielsweise kann der Wert 0x4 verwendet werden, um die Ausrichtung an ein DWORD zu erfordern. Der Wert 0x1 kann verwendet werden, damit das Muster überall beginnen kann.

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