Функция PSPropertyBag_ReadStream (propsys.h)
Считывает поток данных, хранящийся в заданном свойстве, который содержится в указанном контейнере свойств.
Синтаксис
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 .
Комментарии
Вызывающий объект функции PSPropertyBag_ReadStream должен вызвать метод IUnknown::Release для объекта IStream, возвращаемого этой функцией.
Функции 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 или более поздняя) |