IWbemObjectAccess::WritePropertyValue-Methode (wbemcli.h)

Die WritePropertyValue-Methode schreibt eine angegebene Anzahl von Bytes in eine Eigenschaft, die durch ein Eigenschaftenhandle identifiziert wird. Verwenden Sie diese Methode, um Zeichenfolgen und alle anderen Nicht-DWORD - oder Nicht-QWORD-Daten festzulegen.

Syntax

HRESULT WritePropertyValue(
  [in] long       lHandle,
  [in] long       lNumBytes,
  [in] const byte *aData
);

Parameter

[in] lHandle

Ganze Zahl, die das Handle enthält, das diese Eigenschaft identifiziert.

[in] lNumBytes

Ganze Zahl, die die Anzahl der Bytes enthält, die in die -Eigenschaft geschrieben werden. Bei Eigenschaftswerten ohne Zeichenfolge muss lNumBytes die richtige Datengröße des angegebenen Eigenschaftstyps aufweisen. Für Zeichenfolgeneigenschaftswerte wie reference, string und datetime muss lNumBytes die Länge der angegebenen Zeichenfolge in Bytes aufweisen, und die Zeichenfolge selbst muss eine gerade Länge in Bytes aufweisen und mit einem NULL-Terminierungszeichen gefolgt werden.

[in] aData

Zeiger auf das Array vom Konstantenbytetyp, das die Daten enthält.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemcli.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib
DLL	Esscli.dll; Fastprox.dll; Wbemess.dll

Weitere Informationen

IWbemObjectAccess