IIndexableConcept::SetAt-Methode (dbgmodel.h)
Die SetAt-Methode versucht, den Wert auf einen bestimmten n-dimensionalen Index innerhalb des indizierten Objekts festzulegen. Ein Indexer mit N-Dimensionen, bei dem N der von GetDimensionality zurückgegebene Wert ist, muss unterstützt werden. Beachten Sie, dass ein Objekt in verschiedenen Domänen nach unterschiedlichen Typen indiziert werden kann (z. B. über Ordnungs- und Zeichenfolgenindizierung). Einige Indexer sind schreibgeschützt. In solchen Fällen werden E_NOTIMPL von jedem Aufruf der SetAt-Methode zurückgegeben.
Syntax
HRESULT SetAt(
IModelObject *contextObject,
ULONG64 indexerCount,
IModelObject **indexers,
IModelObject *value
);
Parameter
contextObject
Das instance -Objekt (dieser Zeiger), das indiziert wird, wird hier übergeben.
indexerCount
Die Anzahl der Dimensionen, in denen das Objekt indiziert wird.
indexers
Ein Array (entsprechend dem IndexerCount) von Indizes, das angibt, wo innerhalb des instance Objekt zugegriffen werden soll.
value
Der Wert des Elements, das an den angegebenen Indizes zugewiesen werden soll.
Rückgabewert
Diese Methode gibt HRESULT zurück, was auf Erfolg oder Fehler hinweist.
Hinweise
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 |