WritePropertyValue-Funktion

  • Artikel

Schreibt eine angegebene Anzahl von Bytes in eine Eigenschaft, die durch ein Eigenschaftenhandle identifiziert wird.

Hinweis

Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.

Syntax

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

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

ptr
[in] Ein Zeiger auf eine IWbemObjectAccess-Instanz.

lHandle
[in] Eine ganze Zahl mit dem Handle, das diese Eigenschaft bestimmt. Das Handle kann durch Aufrufen der GetPropertyHandle-Funktion abgerufen werden.

lNumBytes
[in] Die Anzahl der Bytes, die in die Eigenschaft geschrieben werden. Weitere Informationen finden Sie im Abschnitt Hinweise.

pHandle [out] Ein Zeiger auf das Bytearray mit den Daten.

Rückgabewert

Die folgenden von dieser Funktion zurückgegebenen Werte werden in der WbemCli.h-Headerdatei definiert, oder Sie können sie als Konstanten im Code definieren:

Konstante Wert BESCHREIBUNG
WBEM_E_INVALID_PARAMETER 0x80041008 Ein Parameter ist nicht gültig.
WBEM_E_TYPE_MISMATCH 0x80041005 Es ist ein Typenkonflikt aufgetreten.
WBEM_S_NO_ERROR 0 Der Funktionsaufruf war erfolgreich.

Bemerkungen

Diese Funktion umschließt einen Aufruf der IWbemClassObject::WritePropertyValue-Methode.

Verwenden Sie diese Funktion, um die Zeichenfolge und alle anderen Nicht-DWORD- bzw. Nicht-QWORD-Daten festzulegen.

Bei Eigenschaftswerten, die keine Zeichenfolgen sind, muss lNumBytes die ordnungsgemäße Datengröße des angegebenen Eigenschaftstyps sein. Bei Werten für Zeichenfolgeneigenschaften muss lNumBytes die Länge der angegebenen Zeichenfolge in Bytes sein, und die Zeichenfolge selbst muss eine gerade Länge in Bytes haben, gefolgt von einem NULL-Beendigungszeichen.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

.NET Framework-Versionen: seit Version 4.7.2 verfügbar

Siehe auch