WindowsInspectString2, fonction (winstring.h)

Permet aux débogueurs d’afficher la valeur d’un HSTRING Windows Runtime 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 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.

Code de retour	Descriptif
E_INVALIDARG	La valeur de l’ordinateur n’est pas IMAGE_FILE_MACHINE_AMD64, IMAGE_FILE_MACHINE_I386, ni IMAGE_FILE_MACHINE_ARM ou targetHString n’est pas un HSTRING correctement formé.

Remarques

La fonction WindowsInspectString transmet les pointeurs d’entrée et de sortie en tant que valeurs de taille de pointeur native. Si la plateforme actuelle est Win32, cette fonction retourne une erreur pour les processus win64.

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

Spécifications

Requirement	Valeur
Client minimum requis	Windows 8
Serveur minimal pris en charge	Windows Server 2012
plateforme cible	Fenêtres
Header	winstring.h
Library	RuntimeObject.lib
DLL	ComBase.dll

Voir aussi

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

WindowsInspectString