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

Article
02/23/2024

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.