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

Article
02/26/2024

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 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

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

Code de retour	Description
S_OK
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.

La méthode a réussi.

Remarques

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