IIndexableConcept::SetAt-Methode (dbgmodel.h)
Die SetAt-Methode versucht, den Wert auf einen bestimmten N-dimensionalen Index innerhalb des indizierten Objekts festzulegen. Ein Indexer von N-Dimensionen, wobei N der von "GetDimensionality" zurückgegebene Wert ist, muss unterstützt werden. Beachten Sie, dass ein Objekt in verschiedenen Domänen durch verschiedene Typen indiziert werden kann (z. B. über Ordinale und Zeichenfolgen indiziert). Einige Indexer sind schreibgeschützt. In solchen Fällen wird E_NOTIMPL von jedem Aufruf der SetAt-Methode zurückgegeben.
Syntax
HRESULT SetAt(
IModelObject *contextObject,
ULONG64 indexerCount,
IModelObject **indexers,
IModelObject *value
);
Parameter
contextObject
Das Instanzobjekt (dieser Zeiger), der indiziert wird, wird hier übergeben.
indexerCount
Die Anzahl der Dimensionen, in die das Objekt indiziert wird.
indexers
Ein Array (größe gemäß indexerCount) von Indizes, das angibt, wo innerhalb des Instanzobjekts zugegriffen werden soll.
value
Der Wert des Elements, das an den angegebenen Indizes zugewiesen werden soll.
Rückgabewert
Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt.
Bemerkungen
Beispielimplementierung:
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;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | dbgmodel.h |