BeginEnumeration, functie

Hiermee wordt een enumerator teruggezet naar het begin van de opsomming.

Notitie

Deze API is alleen voor intern gebruik. Het is niet bedoeld voor gebruik vanuit code voor ontwikkelaars.

Syntaxis

HRESULT BeginEnumeration (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lEnumFlags
);

Parameters

vFunc
[in] Deze parameter is niet gebruikt.

ptr
[in] Een verwijzing naar een IWbemClassObject-exemplaar .

lEnumFlags
[in] Een bitsgewijze combinatie van de vlaggen of waarden die worden beschreven in de sectie Opmerkingen waarmee de eigenschappen in de opsomming worden bepaald.

Retourwaarde

De volgende waarden die door deze functie worden geretourneerd, worden gedefinieerd in het headerbestand WbemCli.h , of u kunt ze definiëren als constanten in uw code:

Constant	Waarde	Beschrijving
WBEM_E_INVALID_PARAMETER	0x80041008	De combinatie van vlaggen in lEnumFlags is ongeldig of er is een ongeldig argument opgegeven.
WBEM_E_UNEXPECTED	0x8004101d	Er is een tweede aanroep naar BeginEnumeration gedaan zonder een tussenliggende aanroep van EndEnumeration.
WBEM_E_OUT_OF_MEMORY	0x80041006	Er is onvoldoende geheugen beschikbaar om een nieuwe opsomming te starten.
WBEM_S_NO_ERROR	0	De functie-aanroep is geslaagd.

Opmerkingen

Met deze functie wordt een aanroep van de methode IWbemClassObject::BeginEnumeration verpakt.

De vlaggen die als argument lEnumFlags kunnen worden doorgegeven, worden gedefinieerd in het headerbestand WbemCli.h . U kunt ze ook definiëren als constanten in uw code. U kunt één vlag van elke groep combineren met een vlag uit een andere groep. Vlaggen van dezelfde groep sluiten elkaar echter uit.

Groep 1

Constant	Waarde	Beschrijving
WBEM_FLAG_KEYS_ONLY	0x4	Neem eigenschappen op die alleen de sleutel vormen.
WBEM_FLAG_REFS_ONLY	0x8	Eigenschappen opnemen die alleen objectverwijzingen zijn.

Groep 2

Constant	Waarde	Beschrijving
WBEM_FLAG_SYSTEM_ONLY	0x30	Beperk de opsomming tot alleen systeemeigenschappen.
WBEM_FLAG_NONSYSTEM_ONLY	0x40	Lokale en doorgegeven eigenschappen opnemen, maar systeemeigenschappen uitsluiten van de opsomming.

Voor klassen:

Constant	Waarde	Beschrijving
WBEM_FLAG_CLASS_OVERRIDES_ONLY	0x100	Beperk de opsomming tot eigenschappen die in de klassedefinitie worden overschreven.
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES	0x100	Beperk de opsomming tot eigenschappen die worden overschreven in de huidige klassedefinitie en tot nieuwe eigenschappen die zijn gedefinieerd in de klasse.
WBEM_MASK_CLASS_CONDITION	0x300	Een masker (in plaats van een vlag) om toe te passen op een lEnumFlags waarde om te controleren of WBEM_FLAG_CLASS_OVERRIDES_ONLY of of WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES is ingesteld.
WBEM_FLAG_LOCAL_ONLY	0x10	Beperk de opsomming tot eigenschappen die zijn gedefinieerd of gewijzigd in de klasse zelf.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Beperk de opsomming tot eigenschappen die worden overgenomen van basisklassen.

Voor exemplaren:

Constant	Waarde	Beschrijving
WBEM_FLAG_LOCAL_ONLY	0x10	Beperk de opsomming tot eigenschappen die zijn gedefinieerd of gewijzigd in de klasse zelf.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Beperk de opsomming tot eigenschappen die worden overgenomen van basisklassen.

Vereisten

Platforms: Zie Systeemvereisten.

Header: WMINet_Utils.idl

.NET Framework versies: beschikbaar sinds 4.7.2

Zie ook

• WMI en prestatiemeteritems (niet-beheerde API-verwijzing)