IEnumNames::Reset-Methode (comsvcs.h)

Setzt die Enumerationsfolge auf den Anfang zurück.

Syntax

HRESULT Reset();

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED und E_FAIL sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Enumerationssequenz wurde zurückgesetzt.
S_FALSE	Die Enumerationssequenz wurde zurückgesetzt, aber der Enumerator enthält keine Elemente.

Hinweise

Sie können den S_FALSE Rückgabewert als Optimierung verwenden, um eine leere Enumeration zu erkennen.

Ein Aufruf dieser Methode, der die Sequenz zurücksetzt, garantiert nicht, dass derselbe Satz von Objekten nach dem Zurücksetzen aufgezählt wird, da sich die Auflistung möglicherweise geändert hat.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	comsvcs.h

Weitere Informationen

IEnumNames