IKeyStore ::GetKeyValue, méthode (dbgmodel.h)
La méthode GetKeyValue est la première méthode à laquelle un client va accéder pour trouver la valeur d’une clé particulière dans le magasin de métadonnées. Si la clé spécifiée par l’argument de clé existe dans le magasin (ou s’il s’agit du magasin parent), la valeur de cette clé et toutes les métadonnées associées à celle-ci sont retournées. Si la valeur de la clé est un accesseur de propriété (un IModelPropertyAccessor boxed 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é est 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 aucune utilisation actuelle pour les métadonnées de deuxième niveau. Cet argument doit donc être spécifié comme null.
Valeur de retour
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.
}
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | dbgmodel.h |