Méthode IIndexableConcept ::SetAt (dbgmodel.h)

La méthode SetAt tente de définir la valeur à un index N dimensionnel particulier à partir de l’objet indexé. Un indexeur de N-dimensions où N est la valeur retournée par GetDimensionality doit être pris en charge. Notez qu’un objet peut être indexable dans différents domaines par différents types (par exemple : indexable via des ordinals et des chaînes). Certains indexeurs sont en lecture seule. Dans ce cas, E_NOTIMPL est retourné à partir de n’importe quel appel à la méthode SetAt.

Syntaxe

HRESULT SetAt(
  IModelObject *contextObject,
  ULONG64      indexerCount,
  IModelObject **indexers,
  IModelObject *value
);

Paramètres

contextObject

L’objet instance (ce pointeur) qui est indexé est passé ici.

indexerCount

Nombre de dimensions dans laquelle l’objet est indexé.

indexers

Tableau (dimensionné en fonction de l’indexerCount) d’index indiquant l’emplacement à l’intérieur de l’objet instance auquel accéder.

value

Valeur de l’élément à affecter aux index spécifiés.

Valeur retournée

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

Remarques

Exemple d’implémentation :

IFACEMETHOD(SetAt)(_In_ IModelObject * /*pContextObject*/, 
                   _In_ ULONG64 indexerCount, 
                   _In_reads_(indexerCount) IModelObject ** /*ppIndexers*/, 
                   _In_ IModelObject * /*pValue*/)
{
    // We are read-only.  Do not allow Set.  An implementation would be very 
    // close to the implementation of GetAt (only setting some underlying 
    // value instead of fetching it)
    return E_NOTIMPL;
}

Configuration requise

Condition requise	Valeur
En-tête	dbgmodel.h

Voir aussi

Interface IIndexableConcept