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

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 dans l’espace d’adressage virtuel du processus de la chaîne.

[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 tampon est NULL, ces informations ne sont pas retournées.

[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 dans la cible. 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, Winnls.h)

Voir aussi

IDebugDataSpaces4

readMultiByteStringVirtual

ReadUnicodeStringVirtualWide

  • Last updated on