IModelObject::GetKeyValue, méthode (dbgmodel.h)

La méthode GetKeyValue est la première méthode à laquelle un client se tourne 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 qu’il s’agit d’une valeur 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é est retournée dans cet argument. Dans certains cas d’erreur, les 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é sera éventuellement retourné dans cet argument.

Valeur de retour

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é n’a pas pu être trouvée.

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

   
En-tête dbgmodel.h

Voir aussi

Interface IModelObject