UID | title | description | old-location | tech.root | ms.date | keywords | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | f1_keywords | topic_type | api_type | api_location | api_name | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:dbgeng.IDebugDataSpaces.SearchVirtual |
IDebugDataSpaces::SearchVirtual (dbgeng.h) |
The SearchVirtual method searches the target's virtual memory for a specified pattern of bytes. This method belongs to the IDebugDataSpaces interface. |
debugger\searchvirtual.htm |
debugger |
05/03/2018 |
|
IDebugDataSpaces interface [Windows Debugging],SearchVirtual method, IDebugDataSpaces.SearchVirtual, IDebugDataSpaces2 interface [Windows Debugging],SearchVirtual method, IDebugDataSpaces2::SearchVirtual, IDebugDataSpaces3 interface [Windows Debugging],SearchVirtual method, IDebugDataSpaces3::SearchVirtual, IDebugDataSpaces4 interface [Windows Debugging],SearchVirtual method, IDebugDataSpaces4::SearchVirtual, IDebugDataSpaces::SearchVirtual, IDebugDataSpaces_9af5d620-f8df-430c-88ab-0d4f96844499.xml, SearchVirtual, SearchVirtual method [Windows Debugging], SearchVirtual method [Windows Debugging],IDebugDataSpaces interface, SearchVirtual method [Windows Debugging],IDebugDataSpaces2 interface, SearchVirtual method [Windows Debugging],IDebugDataSpaces3 interface, SearchVirtual method [Windows Debugging],IDebugDataSpaces4 interface, dbgeng/IDebugDataSpaces2::SearchVirtual, dbgeng/IDebugDataSpaces3::SearchVirtual, dbgeng/IDebugDataSpaces4::SearchVirtual, dbgeng/IDebugDataSpaces::SearchVirtual, debugger.searchvirtual |
dbgeng.h |
Dbgeng.h |
Desktop |
Windows |
|
|
|
|
|
The SearchVirtual method searches the target's virtual memory for a specified pattern of bytes.
Specifies the location in the target's virtual address space to start searching for the pattern.
Specifies how far to search for the pattern. A successful match requires the entire pattern to be found before Length bytes have been examined.
Specifies the pattern to search for.
Specifies the size in bytes of the pattern. This must be a multiple of the granularity of the pattern.
Specifies the granularity of the pattern. For a successful match the pattern must occur a multiple of this value after the start location.
Receives the location in the target's virtual address space of the pattern, if it was found.
This method can also return error values. See Return Values for more details.
Return code | Description |
---|---|
|
The method was successful. |
|
After examining Length bytes the pattern was not found. |
This method searches the target's virtual memory for the first occurrence, subject to granularity, of the pattern entirely contained in the Length bytes of the target's memory starting at the location Offset.
PatternGranularity can be used to ensure the alignment of the match relative to Offset. For example, a value of 0x4 can be used to require alignment to a DWORD. A value of 0x1 can be used to allow the pattern to start anywhere.
For additional options, including the ability to restrict the search to writable memory, see SearchVirtual2.