QualifierSet_GetNames funkce

Načte názvy všech kvalifikátorů nebo určitých kvalifikátorů, které jsou k dispozici z aktuálního objektu nebo vlastnosti.

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_GetNames (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] SAFEARRAY (BSTR)**  pstrNames
);

Parametry

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

ptr
[v] Ukazatel na instanci IWbemQualifierSet .

lFlags
[v] Jeden z následujících příznaků nebo hodnot, které určují, které názvy se mají zahrnout do výčtu.

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.

pstrNames
[out] Nový SAFEARRAY , který obsahuje požadované názvy. Pole může mít 0 prvků. Pokud dojde k chybě, nový SAFEARRAY se nevrátí.

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 není platný.
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::GetNames .

Po načtení názvů kvalifikátoru můžete ke každému kvalifikátoru přistupovat podle názvu voláním funkce QualifierSet_Get .

U daného objektu se nejedná o chybu, která by měla nula kvalifikátorů, takže počet řetězců při pstrNames vrácení může být 0, i když funkce vrátí WBEM_S_NO_ERROR.

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)