Функция PSPropertyBag_ReadStream (propsys.h)

Статья
03/01/2024

Считывает поток данных, хранящийся в заданном свойстве, который содержится в указанном контейнере свойств.

Синтаксис

PSSTDAPI PSPropertyBag_ReadStream(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] IStream      **value
);

Параметры

[in] propBag

Тип: IPropertyBag*

Указатель на объект IPropertyBag , представляющий контейнер свойств, в котором хранится свойство.

[in] propName

Тип: LPCWSTR

Указатель на строку имени свойства, завершаемую null.

[out] value

Тип: IStream**

Адрес указателя, который при успешном возврате этой функции получает объект IStream .

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

Тип: HRESULT

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Функции IPropertyBag и IPersistPropertyBag оптимизируют функцию "Сохранить как текст". IPropertyBag и IPropertyBag2 предоставляют объект с контейнером свойств, в котором объект может постоянно сохранять свои свойства. IPropertyBag2 позволяет объекту получать сведения о типе для каждого свойства: IPropertyBag2::Read вызывает чтение одного или нескольких свойств из контейнера свойств, а IPropertyBag2::Write вызывает сохранение одного или нескольких свойств в контейнере свойств.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	propsys.h
Библиотека	Propsys.lib
DLL	Propsys.dll (версия 6.0 или более поздняя)

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

PSPropertyBag_WriteStream

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