IModelIterator::Reset-Methode (dbgmodel.h)
Die Reset-Methode für einen Iterator, der vom iterierbaren Konzept zurückgegeben wird, stellt die Position des Iterators wieder her, an der es war, als der Iterator zum ersten Mal erstellt wurde (vor dem ersten Element). Es wird zwar dringend empfohlen, die Reset-Methode von Iterator zu unterstützen, es ist jedoch nicht erforderlich. Ein Iterator kann das Äquivalent eines C++-Eingabe-Iterators sein und nur einen einzelnen Durchlauf der Vorwärtsiteration zulassen. In diesem Fall kann die Reset-Methode mit E_NOTIMPL fehlschlagen.
Syntax
HRESULT Reset();
Rückgabewert
Diese Methode gibt HRESULT zurück.
Bemerkungen
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 |