Funkce Get

Načte zadanou hodnotu vlastnosti, pokud existuje.

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 Get (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Parametry

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

ptr
[v] Ukazatel na instanci IWbemClassObject .

wszName
[v] Název vlastnosti.

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

pVal
[out] Pokud se funkce úspěšně vrátí, obsahuje hodnotu wszName vlastnosti . Argumentu pval je přiřazen správný typ a hodnota kvalifikátoru.

pvtType
[out] Pokud se funkce úspěšně vrátí, obsahuje konstantu typu CIM , která označuje typ vlastnosti. Jeho hodnota může být nulltaké .

plFlavor
[out] Pokud se funkce úspěšně vrátí, obdrží informace o původu vlastnosti. Jeho hodnota může být nullnebo jedna z následujících WBEM_FLAVOR_TYPE konstant definovaných v hlavičkovém souboru WbemCli.h :

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 instancí změněna.
WBEM_FLAVOR_ORIGIN_LOCAL	0	Pro třídu: Vlastnost patří do odvozené třídy. Pro instanci: Vlastnost je upravena instancí; to znamená, že byla zadána hodnota nebo byl přidán nebo změněn kvalifikátor.

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_FAILED	0x80041001	Došlo k obecné chybě.
WBEM_E_INVALID_PARAMETER	0x80041008	Nejméně jeden parametr není platný.
WBEM_E_NOT_FOUND	0x80041002	Zadaná vlastnost nebyla nalezena.
WBEM_E_OUT_OF_MEMORY	0x80041006	K dokončení operace není k dispozici dostatek paměti.
WBEM_S_NO_ERROR	0	Volání funkce bylo úspěšné.

Poznámky

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

Funkce Get může také vracet systémové vlastnosti.

Argumentu pVal je přiřazen správný typ a hodnota pro kvalifikátor a funkci COM VariantInit .

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)