IModelObject ::GetKeyValue, méthode (dbgmodel.h)
La méthode GetKeyValue est la première méthode vers laquelle un client se tournera pour obtenir la valeur (et les métadonnées associées) à une clé donnée par nom. Si la clé est un accesseur de propriété , c’est-à-dire sa valeur en tant qu’IModelObject qui est un IModelPropertyAccessor boxé, la méthode GetKeyValue appelle automatiquement la méthode GetValue de l’accesseur de propriété afin de récupérer la valeur réelle.
Syntaxe
HRESULT GetKeyValue(
PCWSTR key,
_COM_Errorptr_opt_ IModelObject **object,
IKeyStore **metadata
);
Paramètres
key
Nom de la clé pour laquelle obtenir une valeur.
object
La valeur de la clé sera retournée dans cet argument. Dans certains cas d’erreur, des informations d’erreur étendues peuvent être passées dans cet argument, même si la méthode retourne un HRESULT défaillant.
metadata
Le magasin de métadonnées associé à cette clé est éventuellement retourné dans cet argument.
Valeur retournée
Cette méthode retourne HRESULT qui indique la réussite ou l’échec. Les valeurs de retour E_BOUNDS (ou E_NOT_SET dans certains cas) indiquent que la clé est introuvable.
Remarques
Exemple de code
ComPtr<IModelObject> spProcess; /* get a process object */
ComPtr<IModelObject> spProcId;
if (SUCCEEDED(spProcess->GetKeyValue(L"Id", &spProcId, nullptr)))
{
// spProcId has a boxed process id. Use GetIntrinsicValueAs to unbox it.
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | dbgmodel.h |