QualifierSet_Next funkce

Načte další kvalifikátor ve výčtu, který byl zahájen voláním funkce QualifierSet_BeginEnumeration .

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 QualifierSet_Next (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] BSTR*               pstrName,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

Parametry

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

ptr [v] Ukazatel IWbemQualifierSet instance.

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

pstrName [out] Název kvalifikátoru. Pokud nullje parametr ignorován, pstrName jinak by neměl odkazovat na platný BSTR nebo nevracení paměti. Pokud není null, funkce vždy přidělí nový BSTR , když vrátí WBEM_S_NO_ERROR.

pVal [out] V případě úspěchu hodnota kvalifikátoru. Pokud funkce selže, VARIANT odkaz na by pVal se nezmění. Pokud je nulltento parametr , parametr se ignoruje.

plFlavor [out] Ukazatel na long, který obdrží příchuť kvalifikátoru. Pokud informace o příchutě nejsou žádoucí, může být nulltento parametr .

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 Parametr není platný.
WBEM_E_UNEXPECTED 0x8004101d Volající nezavolal QualifierSet_BeginEnumeration.
WBEM_E_OUT_OF_MEMORY 0x80041006 K zahájení nového výčtu není k dispozici dostatek paměti.
WBEM_S_NO_MORE_DATA 0x40005 Ve výčtu nezůstane žádné další kvalifikátory.
WBEM_S_NO_ERROR 0 Volání funkce bylo úspěšné.

Poznámky

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

Funkci voláte QualifierSet_Next opakovaně, aby se vyčíslily všechny kvalifikátory, dokud funkce nevrátí WBEM_S_NO_MORE_DATA. Pokud chcete výčet ukončit co nejdříve, zavolejte funkci QualifierSet_EndEnumeration .

Pořadí kvalifikátorů vrácených během výčtu není definováno.

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