Функция StgOpenPropStg (coml2api.h)

Статья
08/22/2023

Функция StgOpenPropStg открывает заданный набор свойств в указанном объекте хранилища или потока. Набор свойств предоставляет предоставленную системой автономную реализацию интерфейса IPropertyStorage .

Синтаксис

HRESULT StgOpenPropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

Параметры

[in] pUnk

Указатель интерфейса для интерфейса IUnknown на объекте хранилища или потока, который содержит запрошенный объект набора свойств.

[in] fmtid

FMTID свойства, заданного для открытия.

[in] grfFlags

Значения из констант PROPSETFLAG.

[in] dwReserved

Зарезервировано для будущего использования; должно иметь значение нуль.

[out] ppPropStg

Указатель на переменную указателя IPropertyStorage*, которая получает указатель интерфейса на запрошенный набор свойств.

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

Эта функция поддерживает стандартные возвращаемые значения E_INVALIDARG и E_UNEXPECTED, в дополнение к следующим:

StgOpenPropStg открывает запрошенный набор свойств и предоставляет предоставленную системой автономную реализацию интерфейса IPropertyStorage . Запрошенный набор свойств содержится в объекте хранилища или потока, заданном pUnk. Значение параметра grfFlags указывает, указывает ли pUnk объект хранилища или потока. Например, если задано PROPSETFLAG_NONSIMPLE, можно запросить интерфейсIStorage в объекте хранилища.

В любом случае эта функция вызывает pUnk-AddRef> для объекта хранилища или потока, содержащего набор свойств. Вызывающий объект должен освободить объект, если это больше не требуется.

Эта функция аналогична методу IPropertySetStorage::Open . Однако StgOpenPropStg добавляет параметры pUnk и grfFlags , включая значение PROPSETFLAG_UNBUFFERED для параметра grfFlags . Используйте эту функцию вместо метода Open, если у вас есть интерфейс IStorage , который не поддерживает интерфейс IPropertySetStorage , или если вы хотите использовать значение PROPSETFLAG_UNBUFFERED. Дополнительные сведения об использовании PROPSETFLAG_UNBUFFERED см. в разделе Константы PROPSETFLAG.

Параметр grfFlags представляет собой сочетание значений, взятых из констант PROPSETFLAG. Поддерживается новое значение перечисления PROPSETFLAG_UNBUFFERED. Дополнительные сведения см. в разделе Константы PROPSETFLAG.

Эта функция экспортируется из распространяемого iprop.dll, которая входит в состав Windows NT 4.0 с пакетом обновления 2 (SP2) и доступна в качестве распространяемого компонента в Windows 95 и более поздних версиях. В Windows 2000 он экспортируется из Ole32.dll. Его также можно экспортировать из iprop.dll в Windows 2000, но вызов перенаправляется в ole32.dll.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	coml2api.h (включая Propidl.h)
Библиотека	Ole32.lib
DLL	Ole32.dll