Метод IWbemObjectAccess::ReadPropertyValue (wbemcli.h)
Метод ReadPropertyValue возвращает указанное количество байтов свойства, связанного с дескриптором свойства. Этот метод используется для считывания значения свойства, содержащего строку, или для чтения свойства, содержащего значение длиной не 32 (DWORD) или 64 (QWORD).
Синтаксис
HRESULT ReadPropertyValue(
[in] long lHandle,
[in] long lBufferSize,
[out] long *plNumBytes,
[out] byte *aData
);
Параметры
[in] lHandle
Целое число, содержащее дескриптор, определяющий это свойство.
[in] lBufferSize
Целое число, содержащее размер буфера.
[out] plNumBytes
Указатель на целое число, используемое для возврата количества прочитанных байтов.
[out] aData
Указатель на массив, используемый для возврата данных свойства.
Возвращаемое значение
Этот метод возвращает WBEM_S_NO_ERROR в случае успешного выполнения. В противном случае этот метод возвращает HRESULT с одним из следующих значений.
Комментарии
Строковые данные возвращаются в виде данных WCHAR, завершаемых значением NULL.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | wbemcli.h (включая Wbemidl.h) |
| Библиотека | Wbemuuid.lib |
| DLL | Esscli.dll; Fastprox.dll; Wbemess.dll |