IDebugDataSpaces3 ::ReadHandleData, méthode (dbgeng.h)

Article
02/06/2025

La méthode ReadHandleData récupère des informations sur un objet système spécifié par un handle système.

Syntaxe

HRESULT ReadHandleData(
  [in]            ULONG64 Handle,
  [in]            ULONG   DataType,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  DataSize
);

Paramètres

[in] Handle

Spécifie le handle système de l’objet dont les données sont demandées. Consultez Handles pour plus d’informations sur les handles système.

[in] DataType

Spécifie le type de données à retourner pour le handle système. Le tableau suivant contient les valeurs valides, ainsi que le type de retour correspondant :

Valeur	Description
DEBUG_HANDLE_DATA_TYPE_BASIC	Retourne des informations de base sur l’objet système. Dans ce cas, l’argument tampon peut être considéré comme ayant le type PDEBUG_HANDLE_DATA_BASIC.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME	Retourne le nom du type d’objet. Par exemple, « Process » ou « Thread ». Dans ce cas, l’argument tampon peut être considéré comme ayant le type PSTR.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME	Retourne le nom de l’objet. Cela inclut son emplacement dans le répertoire d’objets. Dans ce cas, l’argument tampon peut être considéré comme ayant le type PSTR.
DEBUG_HANDLE_DATA_TYPE_HANDLE_COUNT	Retourne le nombre de handles détenus par l’objet. Ceci est similaire au champ DEBUG_HANDLE_DATA_BASIC.HandleCount. Dans ce cas, l’argument tampon peut être considéré comme ayant le type PULONG.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME_WIDE	Retourne le nom du type d’objet. Dans ce cas, l’argument tampon peut être considéré comme ayant le type PWSTR
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE	Retourne le nom de l’objet. Dans ce cas, l’argument tampon peut être considéré comme ayant le type PWSTR.

[out, optional] Buffer

Reçoit les données de l’objet. Une fois la méthode terminée, le contenu de cette mémoire tampon est accessible en cas de conversion de tampon sur le type spécifié dans le tableau ci-dessus.

Si tampon est NULL, ces informations 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] DataSize

Reçoit la taille des données en octets. Si DataSize est NULL, ces informations ne sont pas retournées.

Valeur de retour

Retourner le code	Description
S_OK	La méthode a réussi.

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

Remarques

Cette méthode n’est disponible que dans le débogage en mode utilisateur.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h)

Voir aussi

Poignées

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

Partager via