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

Article
02/06/2025

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

Syntaxe

HRESULT ReadUnicodeStringVirtualWide(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [out, optional] PWSTR   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

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

Retourner le code	Description
S_OK
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.

La méthode a réussi.

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