ExtRemoteData::GetString(PWSTR,ULONG,ULONG,bool,PULONG)-Methode (engextcpp.hpp)

Artikel
02/29/2024

Die GetString-Methode liest eine NULL-Zeichenfolge aus dem Arbeitsspeicher des Ziels. Die Zeichenfolge befindet sich am Anfang der Region, die durch das ExtRemoteData-Objekt dargestellt wird.

Syntax

PWSTR GetString(
  [out] PWSTR  Buffer,
  [in]  ULONG  BufferChars,
  [in]  ULONG  MaxChars,
  [in]  bool   MustFit,
        PULONG NeedChars
);

Parameter

[out] Buffer

Empfängt die null-beendete Zeichenfolge, die vom Ziel gelesen wird. Der Typ des Puffers muss mit dem Typ der Zeichenfolge für das Ziel identisch sein. Wenn die Zeichenfolge eine Unicode-Zeichenfolge ist, muss der Typ des Puffers PWSTR sein. Wenn es sich bei der Zeichenfolge um eine Multibytezeichenfolge handelt, muss der Puffertyp PSTR sein.

Beachten Sie, dass der Rest des Pufferpuffers nach der Zeichenfolge von dieser Methode überschrieben werden kann.

[in] BufferChars

Gibt die Größe des Pufferpuffers in Zeichen an.

[in] MaxChars

Gibt die maximale Anzahl von Zeichen an, die aus dem Ziel gelesen werden sollen.

[in] MustFit

Gibt an, was geschieht, wenn die Zeichenfolge größer als BufferChars-Zeichen ist. Wenn MustFit ist true und die Zeichenfolge größer als BufferChars-Zeichen ist, wird eine ExtRemoteException ausgelöst. Wenn MustFit ist false und die Zeichenfolge größer als BufferChars-Zeichen ist, wird die Zeichenfolge abgeschnitten und null-beendet, um in den Pufferpuffer zu passen.

NeedChars

Rückgabewert

GetString gibt die NULL-Zeichenfolge zurück, die aus dem Ziel gelesen wurde. Dies ist Puffer.

Hinweise

Diese Methode kann nur verwendet werden, wenn sich die vom ExtRemoteData-Objekt dargestellte Region im virtuellen Arbeitsspeicher befindet. Es funktioniert nicht, wenn die Region physischen Arbeitsspeicher angibt.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	engextcpp.hpp (include Engextcpp.hpp)

Weitere Informationen

ExtRemoteData

ExtRemoteData::ReadBuffer

Freigeben über