ExtRemoteData::GetString (PSTR,ULONG,ULONG,bool,PULONG) 方法 (engextcpp.hpp)
GetString 方法从目标的内存中读取以 null 结尾的字符串。 字符串位于 ExtRemoteData 对象表示的区域的开头。
语法
PSTR GetString(
[out] PSTR Buffer,
[in] ULONG BufferChars,
[in] ULONG MaxChars,
[in] bool MustFit,
PULONG NeedChars
);
参数
[out] Buffer
接收从目标读取的以 null 结尾的字符串。 Buffer 的类型必须与目标上的字符串类型相同。 如果字符串是 Unicode 字符串,则 Buffer 的类型必须为 PWSTR。 如果字符串是多字节字符串,则 Buffer 的类型必须为 PSTR。
请注意 ,此方法可以覆盖字符串后面的 Buffer 缓冲区的其余部分。
[in] BufferChars
指定 缓冲区 的大小(以字符为单位)。
[in] MaxChars
指定要从目标中读取的最大字符数。
[in] MustFit
指定当字符串大于 BufferChars 字符时会发生什么情况。 如果 MustFit 为 true
且字符串大于 BufferChars 字符,则将引发 ExtRemoteException 。 如果 MustFit 为 false
,并且字符串大于 BufferChars 字符,则字符串将被截断并以 null 结尾,以适应 Buffer 缓冲区。
NeedChars
返回值
GetString 返回从目标读取的以 null 结尾的字符串。 这是 缓冲区。
注解
仅当 ExtRemoteData 对象表示的区域在虚拟内存中时,才能使用此方法。 如果区域指定了物理内存,则它不起作用。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | engextcpp.hpp (包括 Engextcpp.hpp) |