IModelPropertyAccessor ::GetValue, méthode (dbgmodel.h)

La méthode GetValue est le getter de l’accesseur de propriété. Elle est appelée chaque fois qu’un client souhaite récupérer la valeur sous-jacente de la propriété. Notez que tout appelant qui obtient directement un accesseur de propriété est chargé de transmettre le nom de clé et l’objet d’instance précis (ce pointeur) à la méthode GetValue de l’accesseur de propriété.

Syntaxe

HRESULT GetValue(
  PCWSTR       key,
  IModelObject *contextObject,
  IModelObject **value
);

Paramètres

key

Nom de la clé pour laquelle obtenir une valeur. Un appelant qui extrait directement un accesseur de propriété est responsable de la transmission exacte.

contextObject

Objet de contexte (instance de ce pointeur) à partir duquel l’accesseur de propriété a été récupéré.

value

La valeur sous-jacente de la propriété est retournée ici.

Valeur de retour

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

Remarques

exemple de code

// The full implementation class is shown for clarity.
class MyReadOnlyProperty :
    public Microsoft::WRL::RuntimeClass<
        Microsoft::WRL::RuntimeClassFlags<
            Microsoft::WRL::RuntimeClassType::ClassicCom
            >,
        IModelPropertyAccessor
        >
{
public:

    IFACEMETHOD(GetValue)(_In_ PCWSTR /*pwszKey*/, 
                          _In_ IModelObject * /*pContextObject*/, 
                          _COM_Errorptr_ IModelObject **ppValue)
    {
        HRESULT hr = S_OK;
        *ppValue = nullptr;

        VARIANT vtValue;
        vtValue.vt = VT_I4;
        vtValue.lVal = m_value;
        
        ComPtr<IModelObject> spValue;
        hr = GetManager()->CreateIntrinsicObject(ObjectIntrinsic, &vtValue, &spValue);
        if (SUCCEEDED(hr))
        {
            *ppValue = spValue.Detach();
        }

        return hr;
    }

    IFACEMETHOD(SetValue)(_In_ PCWSTR /*pwszKey*/, 
                          _In_ IModelObject * /*pContextObject*/, 
                          _In_ IModelObject * /*pValue*/)
    {
        // We are a read only property.
        return E_NOTIMPL;
    }

    HRESULT RuntimeClassInitialize(_In_ int value)
    {
        m_value = value;
        return S_OK;
    }

private:

    int m_value;
};

Exigences

Exigence	Valeur
d’en-tête	dbgmodel.h

Voir aussi

interface IModelPropertyAcessor