Fonction WindowsInspectString2 (winstring.h)

Permet aux débogueurs d’afficher la valeur d’un Windows Runtime HSTRING dans un autre espace d’adressage, à distance ou à partir d’un vidage.

Syntaxe

HRESULT WindowsInspectString2(
  UINT64                     targetHString,
  USHORT                     machine,
  PINSPECT_HSTRING_CALLBACK2 callback,
  void                       *context,
  UINT32                     *length,
  UINT64                     *targetStringAddress
);

Paramètres

targetHString

[in]

HSTRING à inspecter.

machine

Format de l’espace d’adressage cible. Les valeurs valides sont IMAGE_FILE_MACHINE_AMD64 pour Win64, IMAGE_FILE_MACHINE_I386 pour Win32 ou IMAGE_FILE_MACHINE_ARM pour ARM 32 bits.

callback

[in]

Fonction de rappel pour lire la mémoire tampon de chaîne à partir de l’espace d’adressage cible. Cette fonction est appelée avant que les paramètres length et targetStringAddress ne soient calculés par la fonction WindowsInspectString2 .

context

[in, facultatif]

Données de contexte personnalisées transmises au rappel.

length

[out]

Longueur de la chaîne dans l’espace d’adressage cible, si l’appel au rappel réussit ; sinon, 0.

targetStringAddress

[out]

Adresse cible du PCWSTR brut, si l’appel au rappel réussit ; sinon, NULL.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Remarques

La fonction WindowsInspectString transmet les pointeurs d’entrée et de sortie sous forme de valeurs natives de la taille du pointeur. Si la plateforme actuelle est Win32, cette fonction retourne une erreur pour les processus qui sont Win64.

WindowsInspectString2 permet le débogage inter-architecture en autorisant des valeurs jusqu’à 64 bits lorsqu’elles sont appelées à partir d’applications Win32 et Win64.

Configuration requise

Voir aussi

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

WindowsInspectString