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 |