EndEnumeration-Funktion
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