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

Статья
08/22/2023

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

Синтаксис

HRESULT StgCreatePropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  const CLSID      *pclsid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

Параметры

[in] pUnk

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

[in] fmtid

FMTID создаваемого свойства.

[in] pclsid

Указатель на исходный идентификатор CLSID для этого набора свойств. Может иметь значение NULL, в этом случае pclsid устанавливается для всех нулей.

[in] grfFlags

Значения из констант PROPSETFLAG , которые определяют, как создается и открывается набор свойств.

[in] dwReserved

Защищены; значение должно быть равно нулю.

[out] ppPropStg

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

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

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

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

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

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

Набор свойств автоматически содержит свойства кодовой страницы и идентификатора языкового стандарта (ID). Для них задано текущее системное значение по умолчанию и текущее значение по умолчанию пользователя соответственно.

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

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

Требования

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