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

Функция SHPropStgCreate (shlobj_core.h)

  • Статья

[Эта функция доступна в Windows XP с пакетом обновления 2 (SP2) и Windows Server 2003. Он может быть изменен или недоступен в последующих версиях Windows.]

Обеспечивает правильную обработку извлечения или назначения кодовой страницы для запрошенной операции набора свойств.

Синтаксис

SHSTDAPI SHPropStgCreate(
  [in]            IPropertySetStorage *psstg,
  [in]            REFFMTID            fmtid,
  [in, optional]  const CLSID         *pclsid,
                  DWORD               grfFlags,
                  DWORD               grfMode,
                  DWORD               dwDisposition,
  [out]           IPropertyStorage    **ppstg,
  [out, optional] UINT                *puCodePage
);

Параметры

[in] psstg

Тип: IPropertySetStorage*

Указатель на интерфейс IPropertySetStorage .

[in] fmtid

Тип: REFFMTID

Идентификатор открываемого набора свойств. Значения для этого параметра могут быть одним из значений, определенных в разделе Предопределенные идентификаторы формата набора свойств , или любые другие зарегистрированные значения FMTID.

[in, optional] pclsid

Тип: const CLSID*

Указатель на ИДЕНТИФИКАТОР CLSID, связанный с набором. Этот параметр может принимать значение NULL.

grfFlags

Тип: DWORD

Один или несколько элементов перечисления PROPSETFLAG , которые определяют, как создается и открывается набор свойств. Все наборы, содержащие байты ANSI, должны создаваться с помощью PROPSETFLAG_ANSI, в противном случае PROPSETFLAG_DEFAULT.

grfMode

Тип: DWORD

Флаги перечисления STGM , указывающие условия для создания и удаления объекта и режимы доступа для объекта. Должен содержать STGM_DIRECT | STGM_SHARE_EXCLUSIVE.

dwDisposition

Тип: DWORD

Одно из следующих значений, определенное в Fileapi.h.

CREATE_NEW (1)

Создайте новый набор, если он еще не существует.

CREATE_ALWAYS (2)

Всегда создавайте новый набор, перезаписыв любой существующий набор.

OPEN_EXISTING (3)

Откройте существующий набор.

OPEN_ALWAYS (4)

[out] ppstg

Тип: IPropertyStorage**

При возврате этого метода содержит указатель интерфейса IPropertyStorage .

[out, optional] puCodePage

Тип: UINT*

При возврате этого метода содержит адрес идентификатора кодовой страницы для набора.

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

Тип: HRESULT

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

Требования

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