Méthode IDebugDataSpaces4 ::ReadMultiByteStringVirtual (dbgeng.h)
La méthode ReadMultiByteStringVirtual lit une chaîne multioctet terminée par null à partir de la cible.
Syntaxe
HRESULT ReadMultiByteStringVirtual(
[in] ULONG64 Offset,
[in] ULONG MaxBytes,
[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.
[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.
[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
Code de retour | Description |
---|---|
|
La méthode a réussi. |
|
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. |
|
Un élément de terminaison 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 comporte plus de caractères BufferSize , la chaîne sera 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) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour