Funkce GetPropertyQualifierSet

Načte sadu kvalifikátoru pro konkrétní vlastnost.

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 GetPropertyQualifierSet (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszProperty,
   [out] IWbemQualifierSet  **ppQualSet
);

Parametry

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

ptr
[v] Ukazatel na instanci IWbemClassObject .

wszMethod
[v] Název vlastnosti. wszProperty musí odkazovat na platnou LPCWSTRhodnotu .

ppQualSet
[out] Přijme ukazatel rozhraní, který umožňuje přístup ke kvalifikátorům vlastnosti. ppQualSet nemůže být null. Pokud dojde k chybě, nový objekt se nevrátí a ukazatel je nastavený na nullhodnotu .

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_NOT_FOUND 0x80041002 Zadaná metoda neexistuje.
WBEM_E_OUT_OF_MEMORY 0x80041006 K dokončení operace není k dispozici dostatek paměti.
WBEM_E_INVALID_PARAMETER 0x80041008 Parametr je null.
WBEM_E_SYSTEM_PROPERTY 0x80041030 Funkce se pokusí získat kvalifikátory systémové vlastnosti.
WBEM_S_NO_ERROR 0 Volání funkce bylo úspěšné.

Poznámky

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

Volání této funkce je podporováno pouze v případě, že aktuální objekt je definicí třídy CIM. Manipulace s metodami není k dispozici pro ukazatele IWbemClassObject , které odkazují na instance CIM.

Vzhledem k tomu, že každá metoda může mít vlastní kvalifikátory, umožňuje ukazatel IWbemQualifierSet volajícímu přidat, upravit nebo odstranit tyto kvalifikátory.

Vzhledem k tomu, že systémové vlastnosti nemají žádné kvalifikátory, funkce vrátí WBEM_E_SYSTEM_PROPERTY , pokud se pokusíte získat ukazatel IWbemQualifierSet pro vlastnost systému.

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é