QualifierSet_Put függvény

A névvel ellátott minősítőt és értéket írja. Az új minősítő felülírja az előző azonos nevű értéket. Ha a minősítő nem létezik, létrejön.

Megjegyzés:

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

Szemantika

HRESULT QualifierSet_Put (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LPCWSTR              wszName,
   [in] VARIANT*             pVal,
   [in] LONG                 lFlavor
);

Paraméterek

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

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

wszName
[in] Az írni kívánt minősítő neve.

pVal
[in] Egy érvényes VARIANT mutató, amely tartalmazza az írandó minősítőt. Ez a paraméter nem lehet null.

lFlavor
[in] Az alábbi állandók egyike, amely meghatározza a minősítő kívánt ízeit. Az alapértelmezett érték a WBEM_FLAVOR_OVERRIDABLE (0).

Állandó	Érték	Description
WBEM_FLAVOR_OVERRIDABLE	0	A minősítő felülbírált egy származtatott osztályban vagy példányban. Ez az alapértelmezett érték.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE	1	A minősítő példányokra lesz propagálása.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS	2	A minősítőt származtatott osztályokba propagálja a felhasználó.
WBEM_FLAVOR_NOT_OVERRIDABLE	0x10	A minősítő nem bírálható felül származtatott osztályban vagy példányban.
WBEM_FLAVOR_AMENDED	0x80	A minősítő honosított.

Visszaadott é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	Description
WBEM_E_CANNOT_BE_KEY	0x8004101f	Érvénytelen kísérlet történt a Key minősítő megadására egy olyan tulajdonságon, amely nem lehet kulcs. A kulcsok egy objektum osztálydefiníciójában vannak megadva, és példányonként nem módosíthatók.
WBEM_E_INVALID_PARAMETER	0x80041008	A paraméter érvénytelen.
WBEM_E_INVALID_QUALIFIER_TYPE	0x80041029	A pVal paraméter nem jogi minősítő típusú.
WBEM_E_OVERRIDE_NOT_ALLOWED	0x8004101a	A metódus nem hívható meg a QualifierSet_Put minősítőn, mert a tulajdonos objektum nem engedélyezi a felülbírálásokat.
WBEM_S_NO_ERROR	0	A függvényhívás sikeres volt.

Megjegyzések

Ez a függvény körbefuttat egy hívást az IWbemQualifierSet::P ut metódushoz.

Requirements

Platformok: Lásd a rendszerkövetelményeket.

Fejléc: WMINet_Utils.idl

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

Lásd még

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