Méthode IDebugDataSpaces2 ::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. 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 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 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 Buffer 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 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 ayant le 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 ayant le 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 cassant La mémoire tampon au type spécifié dans le tableau ci-dessus.

Si La mémoire tampon 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 n’est disponible que 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