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

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