IDebugDataSpaces：：SearchVirtual 方法 (dbgeng.h)
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
接收模式的目标虚拟地址空间中的位置（如果已找到）。
返回值
此方法还可以返回错误值。 有关更多详细信息 ，请参阅返回值 。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
|
检查 长度 字节后，找不到模式。 |
注解
此方法在目标虚拟内存中搜索第一次出现的模式（取决于粒度），该模式完全包含在目标内存的 长度 字节中，从 偏移位置开始。
PatternGranularity 可用于确保匹配相对于 Offset 的对齐方式。 例如，0x4值可用于要求对齐到 DWORD。 值 0x1 可用于允许模式从任意位置开始。
有关其他选项（包括将搜索限制为可写内存的功能），请参阅 SearchVirtual2。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | dbgeng.h (包括 Dbgeng.h) |