IDebugHostField2 ::GetLocationKind, méthode (dbgmodel.h)

Article
02/19/2025

La méthode GetLocationKind retourne le type d’emplacement auquel se trouve le symbole en fonction de l’énumération LocationKind. Cette énumération peut être l’une des valeurs suivantes :

Énumération	Signification
LocationMember	Le champ est un membre de données standard d’une classe, d’une structure, d’une union ou d’une autre construction de type. Il a un décalage qui est relatif à l’adresse de base de la construction de type conteneur. Cette adresse de base est généralement représentée par ce pointeur. Le décalage du champ peut être récupéré via la méthode GetOffset. Les méthodes GetLocation et GetValue échouent pour un champ qui est LocationMember.
LocationStatic	Le champ est statique et a sa propre adresse. La méthode GetLocation retourne l’emplacement abstrait (par exemple, adresse) du champ statique. Les méthodes GetOffset et GetValue échouent pour un champ qui est LocationStatic.
LocationConstant	Le champ est une constante et a une valeur. La méthode GetValue retourne la valeur de la constante. Les méthodes GetOffset et GetLocation échouent pour un champ qui est LocationConstant.
LocationNone	Le champ n’a aucun emplacement. Il a peut-être été optimisé par le compilateur ou il peut s’agir d’un champ statique déclaré mais jamais défini. Quelle que soit la façon dont un tel champ est venu être, il n’a pas de présence physique ou de valeur. Ce n’est que dans les symboles. Toutes les méthodes d’acquisition (GetOffset, GetLocation et GetValue) échouent pour un champ qui est LocationNone.

Syntaxe

HRESULT GetLocationKind(
  LocationKind *locationKind
);

Paramètres

locationKind

Le type d’emplacement de ce champ est retourné ici sous forme de valeur de l’énumération LocationKind.

Valeur de retour

Cette méthode retourne HRESULT qui indique la réussite ou l’échec.

Remarques

exemple de code

ComPtr<IDebugHostField> spField; /* get a field symbol */

LocationKind kind;
if (SUCCEEDED(spField->GetLocationKind(&kind)))
{
    // kind indicates the kind of location (e.g.: static, constant, member, etc...)
}

Exigences

Exigence	Valeur
d’en-tête	dbgmodel.h

Voir aussi

interface IDebugHostField2

Partager via