Partager via


Méthode IDebugDataSpaces3 ::ReadTagged (dbgeng.h)

La méthode ReadTagged lit les données étiquetées qui peuvent être associées à une session de débogueur.

Syntaxe

HRESULT ReadTagged(
  [in]            LPGUID Tag,
  [in]            ULONG  Offset,
  [out, optional] PVOID  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG TotalSize
);

Paramètres

[in] Tag

Spécifie le GUID identifiant les données demandées.

[in] Offset

Spécifie le décalage dans les données à lire.

[out, optional] Buffer

Reçoit les données. Si Buffer a la valeur NULL, les données ne sont pas retournées.

[in] BufferSize

Spécifie la taille en octets de la mémoire tampon. Il s’agit du nombre maximal d’octets qui seront retournés.

[out, optional] TotalSize

Reçoit la taille totale en octets des données spécifiées par balise.

Valeur retournée

Code de retour Description
S_OK
La méthode a réussi.
E_NOINTERFACE
Aucune donnée identifiée par tag n’a pu être trouvée.
 

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Remarques

Certaines sessions de débogueur ont des données supplémentaires arbitraires disponibles. Par exemple, lorsqu’un fichier de vidage est créé, des fichiers d’informations de vidage supplémentaires contenant des informations supplémentaires peuvent également être créés. Ces données supplémentaires sont marquées avec un identificateur unique global et peuvent uniquement être récupérées via la balise .

LPGUID est un pointeur vers un identificateur unique 128 bits. Il est défini dans le fichier d’en-tête Microsoft Windows SDK guiddef.h.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (inclure Dbgeng.h)

Voir aussi

GetNextTagged

IDebugDataSpaces3

IDebugDataSpaces4