Метод IPropertyBag::Read (oaidl.h)

Считывает именованное свойство в инициализированный вызывающий объект VARIANT.

Синтаксис

HRESULT Read(
  LPCOLESTR pszPropName,
  VARIANT   *pVar,
  IErrorLog *pErrorLog
);

Параметры

pszPropName

Адрес имени считываемого свойства. Не может иметь значение NULL.

pVar

Адрес инициализированного вызывающего объекта VARIANT, который получает значение свойства в выходных данных. Функция задает поле типа и поле значения в variant перед возвратом. Если вызывающий объект инициализировал pVar->vt поле при записи, контейнер свойств пытается изменить соответствующее значение на этот тип. Если вызывающий объект задает значение pVar->vt VT_EMPTY, контейнер свойств может использовать любой удобный тип.

pErrorLog

Адрес журнала ошибок вызывающего объекта, в котором контейнер свойств сохраняет все ошибки, возникающие во время чтения. Может иметь значение NULL; В этом случае вызывающий объект не получает ошибок.

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

Hresult

Комментарии

Метод Read указывает контейнеру свойств считывать свойство с именем в pszPropName в инициализированный метод VARIANT вызывающего объекта в pVar. Ошибки регистрируются в журнале ошибок, на который указывает pErrorLog. Если pVar->vt указывает другой указатель объекта (VT_UNKNOWN), контейнер свойств отвечает за создание и инициализацию объекта, описанного в pszPropName.

E_NOTIMPL не является допустимым кодом возврата, так как любой объект, реализующий этот интерфейс, должен поддерживать все функциональные возможности интерфейса.

Требования

Требование	Значение
Минимальная версия клиента	сборка Windows 10 20348
Минимальная версия сервера	сборка Windows 10 20348
Верхняя часть	oaidl.h