Freigeben über


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