Další funkce

Načte další vlastnost ve výčtu, který začíná voláním BeginEnumeration.

Poznámka

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

Syntaxe

HRESULT Next (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lFlags,
   [out] BSTR*            pstrName,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Parametry

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

ptr
[v] Ukazatel na instanci IWbemClassObject .

lFlags
[v] Vyhrazena. Tento parametr musí být 0.

pstrName
[out] Nový BSTR , který obsahuje název vlastnosti. Tento parametr můžete nastavit na, null pokud se název nevyžaduje.

pVal
[out] A VARIANT filled s hodnotou vlastnosti. Pokud hodnota není povinná, můžete tento parametr nastavit na null hodnotu . Pokud funkce vrátí kód chyby, VARIANT předaný do pVal zůstane nezměněný.

pvtType
[out] Ukazatel na proměnnou CIMTYPELONG (do které je umístěn typ vlastnosti). Hodnota této vlastnosti může být , VT_NULL_VARIANTv takovém případě je nutné určit skutečný typ vlastnosti. Tento parametr může být nulltaké .

plFlavor
[out] nullnebo hodnota, která přijímá informace o původu vlastnosti. Možné hodnoty najdete v části [Poznámky].

Vrácená hodnota

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

Konstanta	Hodnota	Popis
WBEM_E_FAILED	0x80041001	Došlo k obecnému selhání.
WBEM_E_INVALID_PARAMETER	0x80041008	Parametr je neplatný.
WBEM_E_UNEXPECTED	0x8004101d	Funkce se nevolala BeginEnumeration .
WBEM_E_OUT_OF_MEMORY	0x80041006	Není k dispozici dostatek paměti pro zahájení nového výčtu.
WBEM_E_TRANSPORT_FAILURE	0x80041015	Vzdálené volání procedury mezi aktuálním procesem a správou systému Windows se nezdařilo.
WBEM_S_NO_ERROR	0	Volání funkce bylo úspěšné.
WBEM_S_NO_MORE_DATA	0x40005	Ve výčtu nejsou žádné další vlastnosti.

Poznámky

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

Tato metoda také vrací systémové vlastnosti.

Pokud je základním typem vlastnosti cesta k objektu, datum nebo čas nebo jiný speciální typ, pak vrácený typ neobsahuje dostatek informací. Volající musí prozkoumat CIMTYPE zadanou vlastnost, aby zjistil, jestli je vlastnost odkazem na objekt, datem nebo časem nebo jiným speciálním typem.

Pokud plFlavor není null, LONG hodnota obdrží informace o původu vlastnosti následujícím způsobem:

Konstanta	Hodnota	Popis
WBEM_FLAVOR_ORIGIN_SYSTEM	0x40	Vlastnost je standardní systémová vlastnost.
WBEM_FLAVOR_ORIGIN_PROPAGATED	0x20	Pro třídu: Vlastnost je zděděna z nadřazené třídy. Pro instanci: Vlastnost zděděná z nadřazené třídy nebyla změněna instancí.
WBEM_FLAVOR_ORIGIN_LOCAL	0	Pro třídu: Vlastnost patří do odvozené třídy. Pro instanci: Vlastnost je změněna instancí; to znamená, že byla zadána hodnota nebo byl přidán nebo změněn kvalifikátor.

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é

• Rozhraní WMI a čítače výkonu (referenční dokumentace nespravovaného rozhraní API)