QualifierSet_BeginEnumeration funkce

Obnoví výčet kvalifikátorů objektu na začátek výčtu.

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 QualifierSet_BeginEnumeration (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags
);

Parametry

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

ptr
[v] Ukazatel na instanci IWbemQualifierSet .

lFlags
[v] Bitová kombinace příznaků nebo hodnot popsaných v části Poznámky , která určuje kvalifikátory, které se mají zahrnout do výčtu.

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_INVALID_PARAMETER	0x80041008	Parametr lFlags není platný.
WBEM_E_UNEXPECTED	0x8004101d	Druhý hovor na QualifierSet_BeginEnumeration adresu byl proveden bez zasahujícího hovoru na QualifierSet_EndEnumerationadresu .
WBEM_E_OUT_OF_MEMORY	0x80041006	Není k dispozici dostatek paměti pro zahájení nového výčtu.
WBEM_S_NO_ERROR	0	Volání funkce bylo úspěšné.

Poznámky

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

Chcete-li vytvořit výčet všech kvalifikátorů objektu, musí být tato metoda volána před prvním voláním QualifierSet_Next. Pořadí, ve kterém jsou kvalifikátory výčtu, je zaručeno, že bude pro daný výčet invariantní.

Příznaky, které lze předat jako lEnumFlags argument, jsou definovány v hlavičce souboru WbemCli.h nebo je můžete definovat jako konstanty v kódu.

Konstanta	Hodnota	Popis
	0	Vrátí názvy všech kvalifikátorů.
WBEM_FLAG_LOCAL_ONLY	0x10	Vrátí pouze názvy kvalifikátorů specifických pro aktuální vlastnost nebo objekt. Pro vlastnost: Vrátí pouze kvalifikátory specifické pro vlastnost (včetně přepsání), a ne kvalifikátory šířené z definice třídy. Pro instanci: Vrátí pouze názvy kvalifikátoru specifické pro konkrétní instanci. Pro třídu: Vrátí pouze kvalifikátory specifické pro odvozenou třídu.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Vrátí pouze názvy kvalifikátorů šířených z jiného objektu. Vlastnost: Vrátí pouze kvalifikátory šířené do této vlastnosti z definice třídy, a ne kvalifikátory ze samotné vlastnosti. Pro instanci: Vrátí pouze ty kvalifikátory šířené z definice třídy. Pro třídu: Vrátí pouze ty názvy kvalifikátoru zděděné z nadřazený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é

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