Метод IDebugDataSpaces4::SearchVirtual (dbgeng.h)

Статья
02/06/2025

Метод SearchVirtual выполняет поиск виртуальной памяти целевого объекта для указанного шаблона байтов.

Синтаксис

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

Параметры

[in] Offset

Указывает расположение в виртуальном адресном пространстве целевого объекта, чтобы начать поиск шаблона.

[in] Length

Указывает, насколько далеко выполняется поиск шаблона. Для успешного совпадения требуется найти весь шаблон до проверки длины байтов.

[in] Pattern

Указывает шаблон для поиска.

[in] PatternSize

Задает размер шаблона в байтах. Это должно быть несколько гранулярности шаблона.

[in] PatternGranularity

Указывает степень детализации шаблона. Для успешного соответствия шаблону необходимо выполнить несколько значений после начального расположения.

[out] MatchOffset

Получает расположение в виртуальном адресном пространстве целевого объекта шаблона, если оно найдено.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.

Возвращаемый код	Описание
S_OK	Метод был успешным.
HRESULT_FROM_NT(STATUS_NO_MORE_ENTRIES)	После изучения длины байтов шаблон не найден.

Замечания

Этот метод выполняет поиск виртуальной памяти целевого объекта для первого вхождения с учетом детализации шаблона, полностью содержащегося в длине байтах памяти целевого объекта, начиная с расположения Смещение.

PatternGranularity можно использовать для обеспечения выравнивания соответствия относительно смещения. Например, значение 0x4 можно использовать для необходимости выравнивания с DWORD. Значение 0x1 можно использовать, чтобы разрешить шаблону начинаться в любом месте.

Дополнительные параметры, включая возможность ограничения поиска на запись памяти, см. в SearchVirtual2.