IDebugDataSpaces4 ::ReadMultiByteStringVirtual, méthode (dbgeng.h)

Article
02/06/2025

La méthode ReadMultiByteStringVirtual lit une chaîne multioctet 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 tampon est NULL, ces informations ne sont pas retournées.

Remarque 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 tampon.

[out, optional] StringBytes

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

Valeur de retour

Retourner le code	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, tampon n’était pas assez volumineux pour contenir la chaîne et la chaîne était tronquée pour s’adapter à tampon. La chaîne tronquée est terminée par null si tampon a de l’espace pour au moins un caractère.
E_INVALIDARG	Un point de terminaison Null n’a pas été trouvé après avoir lu 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 point de terminaison Null. Si la chaîne comporte plus de bufferSize caractères, la chaîne est tronquée pour s’adapter à tampon.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h)

Voir aussi

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual

Partager via