Sdílet prostřednictvím

Funkce BeginEnumeration

Obnoví enumerátor zpět na začátek výčtu.

Poznámka

Toto rozhraní API je určené pouze pro interní použití. Není určen pro použití z kódu vývojáře.

Syntaxe

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

Parametry

vFunc
[v] Tento parametr se nepoužívá.

ptr
[v] Ukazatel na instanci IWbemClassObject .

lEnumFlags
[v] Bitová kombinace příznaků nebo hodnot popsaných v části Poznámky , která řídí vlastnosti zahrnuté ve výčtu.

Vrácená hodnota

Následující hodnoty vrácené touto funkcí jsou definovány v hlavičce souboru WbemCli.h nebo je můžete definovat jako konstanty v kódu:

Konstanta Hodnota Popis
WBEM_E_INVALID_PARAMETER 0x80041008 Kombinace příznaků v lEnumFlags souboru je neplatná nebo byl zadán neplatný argument.
WBEM_E_UNEXPECTED 0x8004101d Druhé volání BeginEnumeration bylo provedeno bez zásahu do EndEnumeration.
WBEM_E_OUT_OF_MEMORY 0x80041006 K zahájení nového výčtu není k dispozici dostatek paměti.
WBEM_S_NO_ERROR 0 Volání funkce bylo úspěšné.

Poznámky

Tato funkce zabalí volání metody IWbemClassObject::BeginEnumeration .

Příznaky, které lze předat jako lEnumFlags argument, jsou definovány v hlavičkovém souboru WbemCli.h nebo je můžete definovat jako konstanty v kódu. Můžete zkombinovat jeden příznak z každé skupiny s libovolným příznakem z jakékoli jiné skupiny. Příznaky ze stejné skupiny se však vzájemně vylučují.

Skupina 1

Konstanta Hodnota Popis
WBEM_FLAG_KEYS_ONLY 0x4 Zahrňte pouze vlastnosti, které tvoří klíč.
WBEM_FLAG_REFS_ONLY 0x8 Zahrnout vlastnosti, které jsou pouze odkazy na objekty.

Skupina 2

Konstanta Hodnota Popis
WBEM_FLAG_SYSTEM_ONLY 0x30 Omezte výčet pouze na systémové vlastnosti.
WBEM_FLAG_NONSYSTEM_ONLY 0x40 Zahrnout místní a šířené vlastnosti, ale vyloučit systémové vlastnosti z výčtu.

Pro třídy:

Konstanta Hodnota Popis
WBEM_FLAG_CLASS_OVERRIDES_ONLY 0x100 Omezte výčet na vlastnosti přepsáné v definici třídy.
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES 0x100 Omezte výčet na vlastnosti přepsané v definici aktuální třídy a na nové vlastnosti definované ve třídě .
WBEM_MASK_CLASS_CONDITION 0x300 Maska (místo příznaku), která se použije u lEnumFlags hodnoty a zkontroluje, jestli je nastavená hodnota WBEM_FLAG_CLASS_OVERRIDES_ONLY nebo WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES .
WBEM_FLAG_LOCAL_ONLY 0x10 Omezit výčet na vlastnosti, které jsou definovány nebo upraveny v samotné třídě.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Omezit výčet na vlastnosti, které jsou zděděné ze základních tříd.

V těchto případech:

Konstanta Hodnota Popis
WBEM_FLAG_LOCAL_ONLY 0x10 Omezit výčet na vlastnosti, které jsou definovány nebo upraveny v samotné třídě.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Omezit výčet na vlastnosti, které jsou zděděné ze základních tříd.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: WMINet_Utils.idl

Verze rozhraní .NET Framework: K dispozici od verze 4.7.2

Viz také

  • Last updated on