Put függvény

Egy elnevezett tulajdonságot új értékre állít be.

Megjegyzés

Ez az API csak belső használatra készült. Nem fejlesztői kódból való használatra készült.

Szintaxis

HRESULT Put (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [in] VARIANT*          pVal,
   [in] CIMTYPE           vtType
);

Paraméterek

vFunc
[in] Ez a paraméter nincs használatban.

ptr
[in] Egy IWbemClassObject-példányra mutató mutató.

wszName
[in] A tulajdonság neve. Ez a paraméter nem lehet null.

lFlags
[in] Fenntartva. Ennek a paraméternek 0-nak kell lennie.

pVal
[in] Egy érvényes VARIANT mutató, amely az új tulajdonságérték lesz. Ha pVal a null vagy típusra VARIANTVT_NULLmutat, a tulajdonság értéke null.

vtType
[in] A által mutatott pValtípusVARIANT. További információért tekintse meg a Megjegyzések szakaszt.

Visszatérési érték

A függvény által visszaadott alábbi értékek a WbemCli.h fejlécfájlban vannak definiálva, vagy konstansként definiálhatók a kódban:

Állandó	Érték	Leírás
WBEM_E_FAILED	0x80041001	Általános hiba történt.
WBEM_E_INVALID_PARAMETER	0x80041008	Egy vagy több paraméter érvénytelen.
WBEM_E_INVALID_PROPERTY_TYPE	0x8004102a	A tulajdonságtípus nem ismerhető fel. Ez az érték akkor jelenik meg, amikor osztálypéldányokat hoz létre, ha az osztály már létezik.
WBEM_E_OUT_OF_MEMORY	0x80041006	Nincs elegendő memória a művelet végrehajtásához.
WBEM_E_TYPE_MISMATCH	0x80041005	Például: Azt jelzi, hogy pVal a tulajdonság helytelen típusúra mutat VARIANT . Osztálydefiníciók esetén: A tulajdonság már létezik a szülőosztályban, és az új COM-típus eltér a régi COM-típustól.
WBEM_S_NO_ERROR	0	A függvényhívás sikeres volt.

Megjegyzések

Ez a függvény az IWbemClassObject::P ut metódus hívását burkolja.

Ez a függvény mindig felülírja az aktuális tulajdonságértéket egy új értékkel. Ha az IWbemClassObject egy osztálydefinícióra mutat, Put létrehozza vagy frissíti a tulajdonság értékét. Ha az IWbemClassObject egy CIM-példányra mutat, Put csak a tulajdonságértéket frissíti, Put és nem tud tulajdonságértéket létrehozni.

A __CLASS rendszertulajdonság csak az osztály létrehozásakor írható, ha nem hagyható üresen. Minden más rendszertulajdonság írásvédett.

A felhasználó nem hozhat létre aláhúzásjellel ("_") kezdődő vagy végződő tulajdonságokkal rendelkező tulajdonságokat. Ez rendszerosztályok és tulajdonságok számára van fenntartva.

Ha a Put függvény által beállított tulajdonság létezik a szülőosztályban, a tulajdonság alapértelmezett értéke megváltozik, kivéve, ha a tulajdonságtípus nem egyezik meg a szülőosztály típusával. Ha a tulajdonság nem létezik, és nem típuseltérés, a tulajdonság létrejön.

vtType A paramétert csak akkor használja, ha új tulajdonságokat hoz létre egy CIM-osztálydefinícióban, és pVal a null típusra VARIANTVT_NULLmutat. Ebben az esetben a vType paraméter a tulajdonság CIM-típusát adja meg. Minden más esetben vtType 0-nak kell lennie. vtType Akkor is 0 értékűnek kell lennie, ha a mögöttes objektum egy példány (még akkor is, ha Val ) nullazért, mert a tulajdonság típusa rögzített, és nem módosítható.

Példa

Példaként tekintse meg az IWbemClassObject::P ut metódust .

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: WMINet_Utils.idl

.NET-keretrendszer verziók: 4.7.2 óta érhető el

Lásd még

• WMI- és teljesítményszámlálók (nem felügyelt API-referencia)