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

Artikel
02/06/2025

Die GetString--Methode liest eine mit Null beendete Zeichenfolge aus dem Speicher des Ziels. Die Zeichenfolge befindet sich am Anfang der Region, die 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-gekündigte Zeichenfolge, die vom Ziel gelesen wird. Der Typ von Buffer muss mit dem Typ der Zeichenfolge für das Ziel übereinstimmen. Wenn es sich bei der Zeichenfolge um eine Unicode-Zeichenfolge handelt, muss der Typ Buffer PWSTR sein. Wenn die Zeichenfolge eine Multibyte-Zeichenfolge ist, muss der Typ des Puffer- PSTR sein.

Hinweis der rest des Buffer Puffers nach der Zeichenfolge von dieser Methode überschrieben werden kann.

[in] BufferChars

Gibt die Größe des Puffer- Puffers in Zeichen an.

[in] MaxChars

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

[in] MustFit

Gibt an, was passiert, wenn die Zeichenfolge größer als BufferChars Zeichen ist. Wenn MustFittrue ist und die Zeichenfolge größer als BufferChars Zeichen ist, wird eine ExtRemoteException- ausgelöst. Wenn MustFit-false ist und die Zeichenfolge größer als BufferChars Zeichen ist, wird die Zeichenfolge abgeschnitten und null-beendet, damit sie in den Puffer Puffer passt.

NeedChars

Rückgabewert

GetString- gibt die mit Null beendete Zeichenfolge zurück, die aus dem Ziel gelesen wurde. Dies ist Buffer.

Bemerkungen

Diese Methode kann nur verwendet werden, wenn sich der durch das ExtRemoteData--Objekt dargestellte Bereich im virtuellen Speicher befindet. Es funktioniert nicht, wenn der Bereich physischen Speicher angibt.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	engextcpp.hpp (include Engextcpp.hpp)

Siehe auch

ExtRemoteData-

ExtRemoteData::ReadBuffer

Freigeben über