Fonction WindowsInspectString (winstring.h)

Article
03/04/2024

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 WindowsInspectString(
  UINT_PTR                  targetHString,
  USHORT                    machine,
  PINSPECT_HSTRING_CALLBACK callback,
  void                      *context,
  UINT32                    *length,
  UINT_PTR                  *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 WindowsInspectString .

context

[in, facultatif]

Données de contexte personnalisées passées 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	Description
E_INVALIDARG	IMAGE_FILE_MACHINE_AMD64 a été spécifié pour la machine, mais la plateforme actuelle n’est pas Win64, ou la machine n’est pas IMAGE_FILE_MACHINE_AMD64, IMAGE_FILE_MACHINE_I386 ou IMAGE_FILE_MACHINE_ARM, ou targetHString n’est pas un HSTRING correctement formé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	winstring.h
Bibliothèque	RuntimeObject.lib
DLL	ComBase.dll

Voir aussi

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

Partager via