IModelIterator::Reset-Methode (dbgmodel.h)
Die Reset-Methode für einen Iterator, der vom Iterable-Konzept zurückgegeben wird, stellt die Position des Iterators an der Stelle wieder her, an der er sich befand, als der Iterator zum ersten Mal erstellt wurde (vor dem ersten Element). Es wird zwar dringend empfohlen, dass der Iterator die Reset-Methode unterstützt, ist jedoch nicht erforderlich. Ein Iterator kann das Äquivalent eines C++-Eingabeiterators sein und nur einen einzelnen Durchlauf der Vorwärtsiteration zulassen. In diesem Fall schlägt die Reset-Methode möglicherweise mit E_NOTIMPL fehl.
Syntax
HRESULT Reset();
Rückgabewert
Diese Methode gibt HRESULT zurück.
Hinweise
Codebeispiel
IFACEMETHOD(Reset)()
{
// It is legal for an iterator to be unable to Reset(). E_NOTIMPL can
// be returned in that case. If an iterator is capable of a reset, it
// should always prefer to implement such.
m_position = 0;
return S_OK;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |