Поделиться через

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

  • Статья

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

Синтаксис

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

Параметры

[in] Offset

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

[in] Length

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

[in] Flags

Задает битовое поле флагов для поиска. В настоящее время единственным битовым флагом, который можно задать, является DEBUG_VSEARCH_WRITABLE_ONLY, который ограничивает поиск доступной для записи памяти.

[in] Pattern

Указывает искомый шаблон.

[in] PatternSize

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

[in] PatternGranularity

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

[out] MatchOffset

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

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

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

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

Комментарии

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

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

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

См. также раздел

IDebugDataSpaces4

SearchVirtual