Put – funkce

Nastaví pojmenovanou vlastnost na novou hodnotu.

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

Parametry

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

ptr
[v] Ukazatel na instanci IWbemClassObject .

wszName
[v] Název vlastnosti. Tento parametr nemůže být null.

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

pVal
[v] Ukazatel na platný VARIANT , který se stane novou hodnotou vlastnosti. Pokud pVal je null nebo odkazuje na VARIANT typ VT_NULL, vlastnost je nastavena na nullhodnotu .

vtType
[v] Typ objektuVARIANT, na který ukazuje .pVal Další informace najdete v části Poznámky .

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_INVALID_PROPERTY_TYPE	0x8004102a	Typ vlastnosti nebyl rozpoznán. Tato hodnota se vrátí při vytváření instancí třídy, pokud třída již existuje.
WBEM_E_OUT_OF_MEMORY	0x80041006	K dokončení operace není k dispozici dostatek paměti.
WBEM_E_TYPE_MISMATCH	0x80041005	Pro instance: Označuje, že pVal odkazuje na objekt VARIANT nesprávného typu pro vlastnost. Definice tříd: Vlastnost již existuje v nadřazené třídě a nový typ modelu COM se liší od starého typu modelu COM.
WBEM_S_NO_ERROR	0	Volání funkce bylo úspěšné.

Poznámky

Tato funkce zabalí volání metody IWbemClassObject::P ut .

Tato funkce vždy přepíše aktuální hodnotu vlastnosti novou hodnotou. Pokud IWbemClassObject odkazuje na definici třídy, Put vytvoří nebo aktualizuje hodnotu vlastnosti. Když IWbemClassObject odkazuje na instanci CIM, Put aktualizuje pouze hodnotu vlastnosti; Put nelze vytvořit hodnotu vlastnosti.

Systémová __CLASS vlastnost je zapisovatelná pouze během vytváření třídy, kdy nemusí být ponechána prázdná. Všechny ostatní systémové vlastnosti jsou jen pro čtení.

Uživatel nemůže vytvořit vlastnosti s názvy, které začínají nebo končí podtržítkem ("_"). To je vyhrazené pro systémové třídy a vlastnosti.

Pokud vlastnost nastavená Put funkcí existuje v nadřazené třídě, výchozí hodnota vlastnosti se změní, pokud typ vlastnosti neodpovídá nadřazené třídě. Pokud vlastnost neexistuje a nejedná se o neshodu typu, vytvoří se vlastnost .

vtType Parametr použijte pouze při vytváření nových vlastností v definici třídy CIM a pVal je null nebo odkazuje na typ VARIANTVT_NULL. V tomto případě vType parametr určuje typ CIM vlastnosti. V každém druhém případě vtType musí být 0. vtType Musí být také 0, pokud je podkladový objekt instancí (i když Val je null), protože typ vlastnosti je pevný a nelze ho změnit.

Příklad

Příklad naleznete IWbemClassObject::P ut metoda.

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)