De functie WritePropertyValue

Schrijft een opgegeven aantal bytes naar een eigenschap die wordt geïdentificeerd door een eigenschapsgreep.

Notitie

Deze API is alleen voor intern gebruik. Het is niet bedoeld voor gebruik vanuit code voor ontwikkelaars.

Syntaxis

HRESULT WritePropertyValue (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] long                 lHandle,
   [in] long                 lNumBytes,
   [in] byte*                aData
);

Parameters

vFunc
[in] Deze parameter is niet gebruikt.

ptr
[in] Een verwijzing naar een IWbemObjectAccess-exemplaar .

lHandle
[in] Een geheel getal dat de ingang bevat die deze eigenschap identificeert. De ingang kan worden opgehaald door de functie GetPropertyHandle aan te roepen.

lNumBytes
[in] Het aantal bytes dat naar de eigenschap wordt geschreven. Zie de sectie Opmerkingen voor meer informatie.

pHandle [uit] Een aanwijzer naar de bytematrix die de gegevens bevat.

Retourwaarde

De volgende waarden die door deze functie worden geretourneerd, worden gedefinieerd in het headerbestand WbemCli.h , of u kunt ze definiëren als constanten in uw code:

Constant	Waarde	Beschrijving
WBEM_E_INVALID_PARAMETER	0x80041008	Een parameter is ongeldig.
WBEM_E_TYPE_MISMATCH	0x80041005	Er is een niet-overeenkomend type opgetreden.
WBEM_S_NO_ERROR	0	De functie-aanroep is geslaagd.

Opmerkingen

Deze functie verpakt een aanroep naar de methode IWbemClassObject::WritePropertyValue .

Gebruik deze functie om tekenreeksen en alle andere niet-DWORD of niet-gegevensQWORD in te stellen.

Voor niet-tekenreekseigenschapswaarden lNumBytes moet de juiste gegevensgrootte van het opgegeven eigenschapstype zijn. Voor tekenreekseigenschapswaarden lNumBytes moet de lengte van de opgegeven tekenreeks in bytes zijn en moet de tekenreeks zelf een even lengte in bytes hebben en worden gevolgd door een null-beëindigingsteken.

Vereisten

Platforms: Zie Systeemvereisten.

Header: WMINet_Utils.idl

.NET Framework versies: beschikbaar sinds 4.7.2

Zie ook

• WMI en prestatiemeteritems (niet-beheerde API-verwijzing)