Méthode IDebugSymbolGroup2 ::OutputAsType (dbgeng.h)

Article
02/23/2024

La méthode OutputAsType modifie le type d’un symbole dans un groupe de symboles. L’entrée du symbole est mise à jour pour représenter le nouveau type.

Syntaxe

HRESULT OutputAsType(
  [in] ULONG Index,
  [in] PCSTR Type
);

Paramètres

[in] Index

Index de l’entrée dans ce groupe de symboles. L’index d’un symbole est un numéro d’identification. L’index est compris entre zéro et le nombre de symboles dans le groupe de symboles moins un.

[in] Type

Nom du type du symbole souhaité. Si le nom commence par un point d’exclamation ( !), le nom est traité comme une extension. Pour plus d’informations sur l’utilisation d’une extension comme type, consultez la section Remarques.

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

Étant donné que les enfants du nouveau type d’entrée peuvent différer des enfants de l’ancien type d’entrée, la méthode OutputAsType supprime tous les enfants de l’entrée du groupe de symboles. Vous pouvez rajouter les enfants à l’aide de la méthode ExpandSymbol .

Si Type est une extension, l’adresse du symbole est passée à l’extension. Chaque ligne de sortie de l’extension devient un symbole enfant du symbole spécifié. Ces symboles enfants sont du texte et vous ne pouvez en aucun cas les manipuler. Par exemple, si le nom d’une variable est @$teb, vous pouvez modifier son type en !teb.

Pour plus d’informations sur les groupes de symboles, consultez Étendues et Groupes de symboles.