WritePropertyValue függvény

Megadott számú bájtot ír egy tulajdonságleíró által azonosított tulajdonságba.

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 WritePropertyValue (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] long                 lHandle,
   [in] long                 lNumBytes,
   [in] byte*                aData
);

Paraméterek

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

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

lHandle
[in] A tulajdonságot azonosító leírót tartalmazó egész szám. A leíró a GetPropertyHandle függvény meghívásával kérhető le.

lNumBytes
[in] A tulajdonságba írt bájtok száma. További információért tekintse meg a Megjegyzések szakaszt.

pHandle [kifelé] Az adatokat tartalmazó bájttömbre mutató mutató.

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_INVALID_PARAMETER	0x80041008	Érvénytelen paraméter.
WBEM_E_TYPE_MISMATCH	0x80041005	Típuseltérés történt.
WBEM_S_NO_ERROR	0	A függvényhívás sikeres volt.

Megjegyzések

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

Ezzel a függvénnyel állíthatja be a sztringet és az összes többi nem vagyDWORD nemQWORD adatot.

Nem sztring tulajdonságértékek lNumBytes esetén a megadott tulajdonságtípus megfelelő adatméretének kell lennie. A karakterlánc-tulajdonságértékek lNumBytes esetében a megadott sztring hosszának bájtban kell lennie, és magának a sztringnek páros hosszúságúnak kell lennie bájtban, és null-végződésű karakterrel kell követnie.

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)