Méthode IKeyStore ::GetKeyValue (dbgmodel.h)
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 |