ExtRemoteData ::GetString(PWSTR,ULONG,ULONG,bool,PULONG) méthode (engextcpp.hpp)

Article
02/06/2025

La méthode GetString lit une chaîne terminée par null à partir de la mémoire de la cible. La chaîne se trouve au début de la région représentée par l’objet ExtRemoteData.

Syntaxe

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

Paramètres

[out] Buffer

Reçoit la chaîne terminée par null lue à partir de la cible. Le type de tampon doit être identique au type de la chaîne sur la cible. Si la chaîne est une chaîne Unicode, le type de tampon doit être PWSTR. Si la chaîne est une chaîne multioctet, le type de mémoire tampon doit être PSTR.

Remarque le reste de la mémoire tampon tampon, après la chaîne, peut être remplacé par cette méthode.

[in] BufferChars

Spécifie la taille, en caractères, de la mémoire tampon tampon.

[in] MaxChars

Spécifie le nombre maximal de caractères à lire à partir de la cible.

[in] MustFit

Spécifie ce qui se passe si la chaîne est supérieure à BufferChars caractères. Si MustFit est true et que la chaîne est supérieure à caractères BufferChars, une ExtRemoteException sera levée. Si MustFit est false et que la chaîne est supérieure à caractères BufferChars, la chaîne est tronquée et terminée par null pour s’adapter à la mémoire tampon tampon tampon.

NeedChars

Valeur de retour

GetString retourne la chaîne terminée par null qui a été lue à partir de la cible. Il s’agit tampon.

Remarques

Cette méthode ne peut être utilisée que si la région représentée par l’objet ExtRemoteData est en mémoire virtuelle. Elle ne fonctionnera pas si la région spécifie la mémoire physique.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	engextcpp.hpp (include Engextcpp.hpp)

Voir aussi

ExtRemoteData

ExtRemoteData ::ReadBuffer

Partager via