Partager via


Interface IKeyStore (dbgmodel.h)

Magasin de clés/valeurs. Généralement utilisé pour les métadonnées.

Héritage

IKeyStore hérite d’IUnknown.

Méthodes

L’interface IKeyStore a ces méthodes.

 
IKeyStore ::AddRef

La méthode IKeyStore ::AddRef incrémente le nombre de références pour une interface sur un objet .
IKeyStore ::ClearKeys

La méthode ClearKeys est analogue à la méthode ClearKeys sur IModelObject.
IKeyStore ::GetKey

La méthode GetKey est analogue à la méthode GetKey sur IModelObject.
IKeyStore ::GetKeyValue

La méthode GetKeyValue est la première méthode qu’un client utilisera pour rechercher la valeur d’une clé particulière dans le magasin de métadonnées.
IKeyStore ::QueryInterface

La méthode IKeyStore ::QueryInterface récupère les pointeurs vers les interfaces prises en charge sur un objet.
IKeyStore ::Release

La méthode IKeyStore ::Release décrémente le nombre de références pour une interface sur un objet.
IKeyStore ::SetKey

La méthode SetKey est analogue à la méthode SetKey sur IModelObject.
IKeyStore ::SetKeyValue

La méthode SetKeyValue est analogue à la méthode SetKeyValue sur IModelObject.

Remarques

Métadonnées dans le modèle de données

L’une des notions fondamentales du modèle de données est qu’un objet (en particulier un objet synthétique) est un dictionnaire de tuples clé/valeur/métadonnées. Chaque clé peut avoir un magasin entier de métadonnées qui lui est associé qui décrit une variété d’éléments entourant la clé et sa valeur potentielle. Notez que les métadonnées ne modifient en aucune façon la valeur de la clé. Il s’agit uniquement d’informations accessoires associées à la clé et à sa valeur qui peuvent affecter la présentation ou d’autres attributs associés de la clé et de sa valeur.

Dans certains sens, un magasin de métadonnées n’est pas tout à fait différent des tuples clé/valeur/métadonnées qui constituent l’essence d’un objet dans le modèle de données. Toutefois, il est simplifié à partir de cette vue. Un magasin de métadonnées est représenté par l’interface IKeyStore . Bien qu’il s’agit également d’une collection de tuples clé/valeur/métadonnées, il existe des limites à ce qui peut être fait avec un magasin de clés de métadonnées par rapport à un objet de modèle :

  • Un magasin de clés ne peut avoir qu’un seul magasin parent. Il ne peut pas avoir une chaîne arbitraire de modèles parents.
  • Un magasin de clés n’a aucun concept. Il ne peut avoir que le dictionnaire de tuples clé/valeur/métadonnées. Cela signifie que les clés présentes dans un magasin de clés sont statiques. Ils ne peuvent pas être créés à la demande par un système de langage dynamique.
  • Par convention uniquement, les valeurs d’un magasin de clés défini par métadonnées sont limitées aux valeurs de base (accesseurs intrinsèques et de propriété)

Bien qu’un magasin de clés puisse avoir un nombre arbitraire (et un nommage arbitraire) de clés, certains noms ont des valeurs sémantiques définies. Pour obtenir la liste de ces valeurs, consultez Interfaces de métadonnées du modèle de données du débogueur.

Configuration requise

Condition requise Valeur
En-tête dbgmodel.h

Voir aussi

Vue d’ensemble du modèle de données C++ du débogueur