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

Article
02/26/2024

La méthode ReadUnicodeStringVirtual lit une chaîne Unicode terminée par null à partir de la cible et la convertit en chaîne multioctet.

Syntaxe

HRESULT ReadUnicodeStringVirtual(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [in]            ULONG   CodePage,
  [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.

[in] CodePage

Spécifie la page de codes à utiliser pour convertir la chaîne multioctet lue à partir de la cible en chaîne Unicode. Par exemple, CP_ACP est la page de codes ANSI.

[out, optional] Buffer

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

[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 dans la cible. 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, buffer n’était pas assez grand pour contenir la chaîne et la chaîne a été tronquée pour tenir dans Buffer. La chaîne tronquée est terminée par null si Buffer a de l’espace pour au moins un caractère.
E_INVALIDARG	Un terminateur 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 contient plus de caractères BufferSize , la chaîne est tronquée pour tenir dans Buffer.