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 終止字串。 這是 Buffer。
備註
只有在 ExtRemoteData 物件所代表的區域位於虛擬記憶體中時,才能使用這個方法。 如果區域指定實體記憶體,它將無法運作。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | engextcpp.hpp (包括 Engextcpp.hpp) |