ExtRemoteData::GetString(PWSTR,ULONG,ULONG,bool,PULONG) メソッド (engextcpp.hpp)
GetString メソッドは、ターゲットのメモリから null で終わる文字列を読み取ります。 文字列は、 ExtRemoteData オブジェクトによって表される領域の先頭にあります。
構文
PWSTR GetString(
[out] PWSTR Buffer,
[in] ULONG BufferChars,
[in] ULONG MaxChars,
[in] bool MustFit,
PULONG NeedChars
);
パラメーター
[out] Buffer
ターゲットから読み取られた null で終わる文字列を受け取ります。 Buffer の型は、ターゲットの文字列の型と同じである必要があります。 文字列が Unicode 文字列の場合、 Buffer の型は PWSTR である必要があります。 文字列がマルチバイト文字列の場合、 Buffer の種類は PSTR である必要があります。
バッファー バッファーの残りの部分は、文字列の後に、このメソッドで上書きできることに注意してください。
[in] BufferChars
バッファー バッファーのサイズを文字数で指定します。
[in] MaxChars
ターゲットから読み取る最大文字数を指定します。
[in] MustFit
文字列が BufferChars 文字より大きい場合の動作を指定します。 MustFit が でtrue、文字列が BufferChars 文字より大きい場合は、ExtRemoteException がスローされます。 MustFit が でfalse、文字列が BufferChars 文字より大きい場合、文字列は切り捨てられ、バッファー バッファー内に収まるように null で終わるようになります。
NeedChars
戻り値
GetString は、ターゲットから読み取られた null で終わる文字列を返します。 これは Buffer です。
注釈
このメソッドは、 ExtRemoteData オブジェクトによって表される領域が仮想メモリ内にある場合にのみ使用できます。 リージョンで物理メモリが指定されている場合は機能しません。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | engextcpp.hpp (Engextcpp.hpp を含む) |