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

Article
02/23/2024

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. Pour plus d’informations sur les handles système, consultez Handles.

[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 Buffer peut être considéré comme ayant un 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 Buffer peut être considéré comme de type PSTR.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME	Retourne le nom de l’objet. Cela inclut son emplacement dans le répertoire de l’objet. Dans ce cas, l’argument Buffer peut être considéré comme de 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 Buffer 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 Buffer peut être considéré comme de type PWSTR
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE	Retourne le nom de l’objet. Dans ce cas, l’argument Buffer peut être considéré comme de type PWSTR.

[out, optional] Buffer

Reçoit les données de l’objet. Une fois la méthode terminée, il est possible d’accéder au contenu de cette mémoire tampon en castant Buffer vers le type spécifié dans le tableau ci-dessus.

Si Buffer a la valeur NULL, ces informations 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] DataSize

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

Valeur retournée

Code de retour	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 est disponible uniquement dans le débogage en mode utilisateur.

Configuration requise

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

Voir aussi

Poignées

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

Partager via