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

Функция SHAddDefaultPropertiesByExt (shobjidl.h)

  • Статья

Добавляет свойства по умолчанию в хранилище свойств как зарегистрированные для указанного расширения файла.

Синтаксис

SHSTDAPI SHAddDefaultPropertiesByExt(
  [in] PCWSTR         pszExt,
  [in] IPropertyStore *pPropStore
);

Параметры

[in] pszExt

Тип: PCWSTR

Указатель на строку Юникода, завершающуюся null, которая указывает расширение.

[in] pPropStore

Тип: IPropertyStore*

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

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

Тип: HRESULT

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

Комментарии

Список свойств, используемых для задания значения по умолчанию, берется из SetDefaultsFor значения реестра ProgID для сопоставления файлов указанного расширения. Список имеет префикс "prop:" и содержит канонические имена свойств для задания значения по умолчанию, например "prop:System.Author;System.Document.DateCreated". Возможные свойства этого списка: System.Author, System.Document.DateCreated и System.Photo.DateTaken. SetDefaultsFor Если значение не существует в ProgID, эта функция использует значение по умолчанию, указанное SetDefaultsFor в значении HKEY_CLASSES_ROOT*.

System.Author имеет значение пользователя, который выполнил действие. System.Document.DateCreated и System.Photo.DateTaken используют текущую дату. Эти три свойства являются единственными, для которых система предоставляет специальные значения по умолчанию.

Обратите внимание, что существует несколько типов свойств:

  1. Свойства, производные от файловой системы (например, размер и дата создания)
  2. Свойства, производные от файла (например, размеры и количество страниц);
  3. Свойства, помещенные в файл (например, author и tags)
При создании нового файла типы один и два предоставляются только путем создания файла. Но свойства типа 3 должны быть явно заданы программой. Система предоставляет SHAddDefaultPropertiesByExt для предоставления значений до трех конкретных свойств типа 3. Иногда windows Обозреватель использует этот API при первом сохранении файла или при создании нового файла после выбора пункта Создать в контекстном меню.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header shobjidl.h
DLL Shell32.dll