Méthode IKeyStore ::GetKeyValue (dbgmodel.h)

  • Article

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. Si la clé spécifiée par l’argument clé existe dans le magasin (ou dans son magasin parent), la valeur de cette clé et toutes les métadonnées qui lui sont associées sont retournées. Si la valeur de la clé est un accesseur de propriété (un IModelPropertyAccessor boxé dans un IModelObject), la méthode GetValue de l’accesseur de propriété est automatiquement appelée par GetKeyValue et la valeur sous-jacente de la propriété retournée.

Syntaxe

HRESULT GetKeyValue(
  PCWSTR                          key,
  _COM_Errorptr_opt_ IModelObject **object,
  IKeyStore                       **metadata
);

Paramètres

key

Nom de la clé pour laquelle retourner une valeur.

object

La valeur de la clé sera retournée ici. Si la valeur de la clé est un accesseur de propriété, la méthode GetValue est appelée sur l’accesseur de propriété et cette valeur sous-jacente est retournée ici..

metadata

Toutes les métadonnées associées à la clé sont éventuellement retournées ici. Il n’existe actuellement aucune utilisation pour les métadonnées de deuxième niveau. Cet argument doit donc généralement être spécifié comme null.

Valeur retournée

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

Remarques

Exemple de code

ComPtr<IKeyStore> spMetadata; /* get a metadata store */

ComPtr<IModelObject> spRadix;
if (SUCCEEDED(spMetadata->GetKeyValue(L"PreferredRadix", &spRadix, nullptr)))
{
    // spRadix has the preferred display radix.  Use GetIntrinsicValueAs to unbox.
}

Configuration requise

Condition requise Valeur
En-tête dbgmodel.h

Voir aussi

Interface IKeyStore