EndEnumeration-Funktion

  • Artikel

Beendet eine Enumerationssequenz, die mit einem Aufruf der BeginEnumeration-Funktion gestartet wurde.

Hinweis

Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.

Syntax

HRESULT EndEnumeration (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr
);

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

ptr
[in] Ein Zeiger auf eine IWbemClassObject-Instanz.

Rückgabewert

Die folgenden von dieser Funktion zurückgegebenen Werte werden in der Headerdatei WbemCli.h definiert. Alternativ dazu können Sie sie als Konstanten im Code definieren:

Konstante Wert BESCHREIBUNG
WBEM_E_FAILED 0x80041001 Ein allgemeiner Fehler ist aufgetreten.
WBEM_S_NO_ERROR 0 Der Funktionsaufruf war erfolgreich.

Bemerkungen

Diese Funktion umschließt einen Aufruf der IWbemClassObject::EndEnumeration-Methode.

Ein Aufruf der EndEnumeration-Funktion ist nicht erforderlich, wird jedoch empfohlen, da dadurch Ressourcen freigegeben werden, die der Enumeration zugeordnet sind. Allerdings werden die Ressourcen automatisch freigegeben, wenn die nächste Enumeration gestartet oder das Objekt freigegeben wird.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

.NET Framework-Versionen: seit Version 4.7.2 verfügbar

Siehe auch