Метод IRecordInfo::P utField (oaidl.h)

Статья
08/25/2023

Помещает вариант в поле.

Синтаксис

HRESULT PutField(
  [in]      ULONG     wFlags,
  [in, out] PVOID     pvData,
  [in]      LPCOLESTR szFieldName,
  [in]      VARIANT   *pvarField
);

Параметры

[in] wFlags

Единственными допустимыми значениями параметра wFlags являются INVOKE_PROPERTYPUT или INVOKE_PROPERTYPUTREF.

Если INVOKE_PROPERTYPUTREF передается в , PutField просто назначает значение варианта, передаваемого в поле, с помощью обычных правил приведения.

Если INVOKE_PROPERTYPUT передается, применяются определенные правила. Если поле объявлено как класс, производный от IDispatch и значение поля равно NULL, возвращается ошибка. Если значение поля не равно NULL, вариант будет передан в свойство по умолчанию, поддерживаемое объектом, на который ссылается поле. Если поле не объявлено как класс, производный от IDispatch , будет возвращена ошибка. Если поле объявлено как вариант типа VT_Dispatch то полю присваивается значение по умолчанию объекта . В противном случае значение варианта присваивается полю.

[in, out] pvData

Указатель на экземпляр записи.

[in] szFieldName

Имя поля записи.

[in] pvarField

Указатель на вариант.

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

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Успешно.
E_INVALIDARG	Один или несколько аргументов недопустимы.

Требования

Требование	Значение
Целевая платформа	Windows
Header	oaidl.h

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

IRecordInfo

Поделиться через