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

Article
03/01/2024

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 mémoire 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 mémoire tampon doit être PWSTR. Si la chaîne est une chaîne multioctet, le type de mémoire tampon doit être PSTR.

Notez que le reste de la mémoire 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 .

[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 plus grande que les caractères BufferChars . Si MustFit est true et que la chaîne est plus grande que les caractères BufferChars , une exception ExtRemoteException est levée. Si MustFit est false et que la chaîne est plus grande que les caractères BufferChars , la chaîne est tronquée et terminée par null pour tenir à l’intérieur de la mémoire tampon.

NeedChars

Valeur retournée

GetString retourne la chaîne terminée par null qui a été lue à partir de la cible. Il s’agit de La mémoire 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. Cela ne fonctionnera pas si la région spécifie la mémoire physique.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	engextcpp.hpp (inclure Engextcpp.hpp)

Voir aussi

ExtRemoteData

ExtRemoteData ::ReadBuffer

Partager via