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
如果找到該模式，則會接收目標虛擬位址空間中的位置。
傳回值
這個方法也可以傳回錯誤值。 如需詳細資訊，請參閱 傳回值。
| 傳回碼 | 描述 |
|---|---|
|
方法成功。 |
|
檢查 長度 位元組之後，找不到模式。 |
言論
這個方法會搜尋目標虛擬記憶體中第一次出現，並受限於數據粒度，該模式完全包含在目標記憶體的 長度 位元組，從位置開始 Offset。
PatternGranularity 可用來確保比對相對於 Offset的對齊方式。 例如，0x4的值可用來要求對齊 DWORD。 0x1的值可用來允許模式在任何地方啟動。
如需其他選項，包括將搜尋限制為可寫入記憶體的功能，請參閱 SearchVirtual2。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 桌面 |
| 標頭 | dbgeng.h （include Dbgeng.h） |