Funktionen WritePropertyValue

Skriver ett angivet antal byte till en egenskap som identifieras av en egenskapsreferens.

Anteckning

Det här API:et är endast för internt bruk. Det är inte avsett för användning från utvecklarkod.

Syntax

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

Parametrar

vFunc
[i] Den här parametern används inte.

ptr
[i] En pekare till en IWbemObjectAccess-instans .

lHandle
[i] Ett heltal som innehåller referensen som identifierar den här egenskapen. Handtaget kan hämtas genom att anropa funktionen GetPropertyHandle .

lNumBytes
[i] Antalet byte som skrivs till egenskapen . Mer information finns i avsnittet Kommentarer .

pHandle [ut] En pekare till bytematrisen som innehåller data.

Returvärde

Följande värden som returneras av den här funktionen definieras i wbemCli.h-huvudfilen , eller så kan du definiera dem som konstanter i koden:

Konstant	Värde	Beskrivning
WBEM_E_INVALID_PARAMETER	0x80041008	En parameter är inte giltig.
WBEM_E_TYPE_MISMATCH	0x80041005	En typmatchningsfel inträffade.
WBEM_S_NO_ERROR	0	Funktionsanropet lyckades.

Kommentarer

Den här funktionen omsluter ett anrop till metoden IWbemClassObject::WritePropertyValue .

Använd den här funktionen för att ange sträng och alla andra icke-DWORD eller icke-dataQWORD .

För egenskapsvärden lNumBytes som inte ärstring måste vara rätt datastorlek för den angivna egenskapstypen. För strängegenskapsvärden lNumBytes måste vara längden på den angivna strängen i byte, och själva strängen måste ha en jämn längd i byte och följas med ett null-avslutningstecken.

Krav

Plattformar: Se Systemkrav.

Huvudet: WMINet_Utils.idl

.NET Framework versioner: Tillgänglig sedan 4.7.2

Se även

• WMI- och prestandaräknare (ohanterad API-referens)