Méthode IDebugDataSpaces4 ::ReadUnicodeStringVirtual (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 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 |
|---|---|
|
La méthode a réussi. |
|
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. |
|
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | dbgeng.h (inclure Dbgeng.h, Winnls.h) |