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

Artikel
02/26/2024

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

Syntax

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

Parameter

[out] Buffer

Empfängt die null-endende Zeichenfolge, die vom Ziel gelesen wird. Der Typ des Puffers muss mit dem Typ der Zeichenfolge auf dem 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 Typ des Puffers 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, damit sie in den Pufferpuffer passt.

NeedChars

Rückgabewert

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

Hinweise

Diese Methode kann nur verwendet werden, wenn sich der durch das ExtRemoteData-Objekt dargestellte Bereich im virtuellen Arbeitsspeicher befindet. Dies 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