Méthode IDebugDataSpaces4 ::ReadMultiByteStringVirtual (dbgeng.h)

Article
02/23/2024

La méthode ReadMultiByteStringVirtual lit une chaîne multioctet terminée par null à partir de la cible.

Syntaxe

HRESULT ReadMultiByteStringVirtual(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [out, optional] PSTR    Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  StringBytes
);

Paramètres

[in] Offset

Spécifie l’emplacement de la chaîne dans l’espace d’adressage virtuel du processus.

[in] MaxBytes

Spécifie le nombre maximal d’octets à lire à partir de la cible.

[out, optional] Buffer

Reçoit la chaîne de la cible. Si La mémoire tampon a la valeur NULL, ces informations ne sont pas retournées.

Note Le reste de la mémoire tampon, après la chaîne retournée, peut être remplacé par cette méthode.

[in] BufferSize

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

[out, optional] StringBytes

Reçoit la taille, en octets, de la chaîne. Si StringBytes a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

Code de retour	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, la mémoire tampon n’était pas assez grande pour contenir la chaîne et la chaîne a été tronquée pour tenir dans La mémoire tampon. La chaîne tronquée est terminée par null si La mémoire tampon a de l’espace pour au moins un caractère.
E_INVALIDARG	Un élément de terminaison null est introuvable après la lecture de MaxBytes à partir de la cible.

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour .

Remarques

Le moteur lit jusqu’à MaxBytes à partir de la cible à la recherche d’un terminateur null. Si la chaîne comporte plus de caractères BufferSize , la chaîne sera tronquée pour tenir dans Buffer.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)

Voir aussi

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual

Partager via