IWbemObjectAccess::ReadPropertyValue-Methode (wbemcli.h)

Die ReadPropertyValue-Methode gibt eine angegebene Anzahl von Bytes einer Eigenschaft zurück, die einem Eigenschaftenhandle zugeordnet ist. Verwenden Sie diese Methode, um den Wert einer Eigenschaft zu lesen, die eine Zeichenfolge enthält, oder um eine Eigenschaft zu lesen, die einen Wert enthält, der nicht 32 (DWORD) oder 64 (QWORD)-Bits lang ist.

Syntax

HRESULT ReadPropertyValue(
  [in]  long lHandle,
  [in]  long lBufferSize,
  [out] long *plNumBytes,
  [out] byte *aData
);

Parameter

[in] lHandle

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

[in] lBufferSize

Ganze Zahl, die die Puffergröße enthält.

[out] plNumBytes

Zeiger auf eine ganze Zahl, die verwendet wird, um die Anzahl der gelesenen Bytes zurückzugeben.

[out] aData

Zeiger auf ein Array, das verwendet wird, um die Eigenschaftendaten zurückzugeben.

Rückgabewert

Diese Methode gibt bei erfolgreicher Ausführung WBEM_S_NO_ERROR zurück. Andernfalls gibt diese Methode ein HRESULT mit einem der folgenden Werte zurück.

Hinweise

Zeichenfolgendaten werden als WCHAR-Daten mit NULL-Beendigung zurückgegeben.

Anforderungen

Weitere Informationen

IWbemObjectAccess