ExtRemoteData::GetString(ExtBuffer<char>*,ULONG) method (engextcpp.hpp)

The GetString method reads a null-terminated string from the target's memory. The string is located in the beginning of the region represented by the ExtRemoteData object.

Syntax

PSTR GetString(
  [out] ExtBuffer<char> *Buffer,
  [in]  ULONG           MaxChars
);

Parameters

[out] Buffer

Receives the null-terminated string read from the target. The type of Buffer must be the same as the type of the string on the target. If the string is a Unicode string, the type of Buffer must be PWSTR. If the string is a multibyte string, the type of Buffer must be PSTR.

Note   the remainder of the Buffer buffer, after the string, can be overwritten by this method.
 

[in] MaxChars

Specifies the maximum number of characters to read from the target.

Return value

GetString returns the null-terminated string that was read from the target. This is Buffer.

Remarks

This method can only be used if the region represented by the ExtRemoteData object is in virtual memory. It will not work if the region specifies physical memory.

Requirements

Requirement Value
Target Platform Desktop
Header engextcpp.hpp (include Engextcpp.hpp)

See also

ExtRemoteData

ExtRemoteData::ReadBuffer