IDebugDataSpaces4 ::ReadTagged, méthode (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 tampon est NULL, les données ne sont pas retournées.
[in] BufferSize
Spécifie la taille en octets de la mémoire tampon 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 de retour
| Retourner le code | Description |
|---|---|
|
La méthode a réussi. |
|
Aucune donnée identifiée par balise est introuvable. |
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 du Kit de développement logiciel (SDK) Microsoft Windows guiddef.h.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | dbgeng.h (include Dbgeng.h) |