ExtRemoteData::SetLong method (engextcpp.hpp)
The ExtRemoteData class provides a wrapper around a small section of a target's memory. ExtRemoteData automatically retrieves the memory and provides a number of convenience methods.
The ExtRemoteData class includes the following constructors and methods:
class ExtRemoteData
{
public:
PCSTR m_Name;
ULONG64 m_Offset;
bool m_ValidOffset;
ULONG m_Bytes;
ULONG64 m_Data;
bool m_ValidData;
bool m_Physical;
ULONG m_SpaceFlags;
};
- m_Name
- The name given to this instance of ExtRemoteData. This name is used to provide meaningful error messages and is set by the constructor, ExtRemoteData::ExtRemoteData.
- m_Offset
- The location in the target's memory (virtual or physical) of the region of memory represented by this instance of ExtRemoteData. It can be set by the ExtRemoteData::ExtRemoteData constructor or by the ExtRemoteData::Set(Typed) or ExtRemoteData::Set(Offset Bytes) methods.
- m_ValidOffset
-
Indicates whether the m_Offsetlocation is valid. If m_ValidOffset is
false
, the location is not valid and most of the methods for this object will not work. In this case, the ExtRemoteData::Set(Typed) or ExtRemoteData::Set(Offset Bytes) methods can be called to change m_Offset to a valid location. - m_Bytes
- The size, in bytes, of the region of memory represented by this object. It can be set by the ExtRemoteData::ExtRemoteData constructor or by the ExtRemoteData::Set(Typed) or ExtRemoteData::Set(Offset Bytes) methods.
- m_Data
- The cached contents of the region of memory specified by this instance of ExtRemoteData. Setting this member is optional. If the region of memory is large, it will not be cached.
- m_ValidData
-
Indicates whether the m_Data cached data is valid. If m_ValidData is
false
, the cached data is not valid and most of the methods for this object will not work. In this case, the ExtRemoteData::Read method can be called to refresh the cached data. - m_Physical
-
Indicates whether the m_Offset location is in the target's virtual address space or in its physical address space. If m_Physical is
true
, the m_Offsetlocation is in the target's physical address space. If m_Physical isfalse
, the m_Offset location is in the target's virtual address space. - m_SpaceFlags
-
The DEBUG_PHYSICAL_XXX flags used for accessing physical memory on the target. These flags are only used if m_Physical is
true
. For a description of these flags, see the ReadPhysical2 method.
Syntax
void SetLong(
LONG Data
);
Parameters
Data
See description.
Return value
None
Requirements
Requirement | Value |
---|---|
Target Platform | Windows |
Header | engextcpp.hpp (include Engextcpp.hpp) |
Library | engextcpp.hpp |