Функция WritePropertyValue

Записывает указанное число байт в свойство, заданное маркером свойства.

Примечание

Этот интерфейс API предназначен только для внутреннего использования. Он не предназначен для использования из кода разработчика.

Синтаксис

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

Параметры

vFunc
[in] Этот параметр не используется.

ptr
[in] Указатель на экземпляр IWbemObjectAccess .

lHandle
[in] Целое число, содержащее дескриптор, идентифицирующий это свойство. Дескриптор можно получить, вызвав функцию GetPropertyHandle .

lNumBytes
[in] Число байтов, записываемых в свойство . Дополнительные сведения см. в разделе Примечания .

pHandle [out] Указатель на массив байтов, содержащий данные.

Возвращаемое значение

Следующие значения, возвращаемые этой функцией, определяются в файле заголовка WbemCli.h , или их можно определить как константы в коде:

Константа Значение Описание
WBEM_E_INVALID_PARAMETER 0x80041008 Недействительный параметр.
WBEM_E_TYPE_MISMATCH 0x80041005 Обнаружено несоответствие типов.
WBEM_S_NO_ERROR 0 Вызов функции выполнен успешно.

Комментарии

Эта функция создает оболочку для вызова метода IWbemClassObject::WritePropertyValue .

Используйте эту функцию для задания строки и всех других данных, не являющихсяDWORD или не-QWORD данными.

Для нестроковых значений lNumBytes свойств должен быть правильным размером данных указанного типа свойства. Для значений lNumBytes строковых свойств значение должно быть длиной указанной строки в байтах, а сама строка должна иметь четную длину в байтах и следовать символу завершения null.

Требования

Платформы: см. раздел Требования к системе.

Заголовка: WMINet_Utils.idl

версии платформа .NET Framework: доступно с версии 4.7.2.

См. также раздел

  • Last updated on