BeginEnumeration függvény

Visszaállítja az enumerátort az enumerálás elejére.

Megjegyzés

Ez az API csak belső használatra készült. Nem fejlesztői kódból való használatra készült.

Szintaxis

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

Paraméterek

vFunc
[in] Ez a paraméter nem használható.

ptr
[in] Egy IWbemClassObject-példányra mutató mutató.

lEnumFlags
[in] A Megjegyzések szakaszban leírt jelzők vagy értékek bitenkénti kombinációja, amely az enumerálásban szereplő tulajdonságokat szabályozza.

Visszatérési érték

A függvény által visszaadott alábbi értékek a WbemCli.h fejlécfájlban vannak definiálva, vagy konstansként definiálhatók a kódban:

Állandó	Érték	Leírás
WBEM_E_INVALID_PARAMETER	0x80041008	A jelölők lEnumFlags kombinációja érvénytelen, vagy érvénytelen argumentum lett megadva.
WBEM_E_UNEXPECTED	0x8004101d	A második hívás a következőre BeginEnumeration irányuló beavatkozás EndEnumerationnélkül történt: .
WBEM_E_OUT_OF_MEMORY	0x80041006	Nincs elég memória az új számbavétel megkezdéséhez.
WBEM_S_NO_ERROR	0	A függvényhívás sikeres volt.

Megjegyzések

Ez a függvény körbefuttat egy hívást az IWbemClassObject::BeginEnumeration metódushoz.

Az argumentumként lEnumFlags átadható jelzők a WbemCli.h fejlécfájlban vannak definiálva, vagy konstansként definiálhatók a kódban. Minden csoportból egyetlen jelölőt kombinálhat bármely másik csoport bármelyik jelölőjével. Az ugyanabból a csoportból származó jelzők azonban kölcsönösen kizárják egymást.

1. csoport

Állandó	Érték	Leírás
WBEM_FLAG_KEYS_ONLY	0x4	Adja meg azokat a tulajdonságokat, amelyek csak a kulcsot alkotják.
WBEM_FLAG_REFS_ONLY	0x8	Csak objektumhivatkozásokat tartalmazó tulajdonságok belefoglalása.

2. csoport

Állandó	Érték	Leírás
WBEM_FLAG_SYSTEM_ONLY	0x30	Csak a rendszertulajdonságokra korlátozza az enumerálást.
WBEM_FLAG_NONSYSTEM_ONLY	0x40	Adjon meg helyi és propagált tulajdonságokat, de zárja ki a rendszertulajdonságokat az enumerálásból.

Osztályok esetén:

Állandó	Érték	Leírás
WBEM_FLAG_CLASS_OVERRIDES_ONLY	0x100	Korlátozza az enumerálást az osztálydefinícióban felülírt tulajdonságokra.
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES	0x100	Korlátozza az enumerálást az aktuális osztálydefinícióban felülírt tulajdonságokra és az osztályban definiált új tulajdonságokra.
WBEM_MASK_CLASS_CONDITION	0x300	Maszk (jelölő helyett) egy értékre lEnumFlags alkalmazva annak ellenőrzéséhez, hogy be van-e WBEM_FLAG_CLASS_OVERRIDES_ONLY állítva.WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES
WBEM_FLAG_LOCAL_ONLY	0x10	Korlátozza az enumerálást az osztályban definiált vagy módosított tulajdonságokra.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Korlátozza az enumerálást az alaposztályokból öröklődő tulajdonságokra.

Példányok esetén:

Állandó	Érték	Leírás
WBEM_FLAG_LOCAL_ONLY	0x10	Korlátozza az enumerálást az osztályban definiált vagy módosított tulajdonságokra.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Korlátozza az enumerálást az alaposztályokból öröklődő tulajdonságokra.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: WMINet_Utils.idl

.NET-keretrendszer verziók: 4.7.2-től érhető el

Lásd még

• WMI- és teljesítményszámlálók (nem felügyelt API-referencia)