通过

SHAddDefaultPropertiesByExt 函数 (shobjidl.h)

  • 项目

将默认属性添加到为指定文件扩展名注册的属性存储区。

语法

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

参数

[in] pszExt

类型： PCWSTR

指向以 null 结尾的 Unicode 字符串的指针，该字符串指定扩展。

[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 上不存在该值，则此函数使用在值 HKEY_CLASSES_ROOT* 上SetDefaultsFor找到的默认值。

System.Author 具有执行操作的用户的值。 System.Document.DateCreated 和 System.Photo.DateTaken 使用当前日期。 这三个属性是系统提供特殊默认值的唯一属性。

请注意，有几种类型的属性：

  1. 派生自文件系统的属性 (，例如大小和创建日期)
  2. 派生自文件 (的属性，例如维度和页数)
  3. 放置在文件 (的属性，例如作者和标记)
创建新文件时，只需创建文件即可提供类型 1 和 2。 但类型 3 的属性必须由程序显式设置。 系统提供 SHAddDefaultPropertiesByExt 来提供最多三个类型为三个特定属性的值。 有时，Windows 资源管理器在首次保存文件时或从快捷菜单选择“ 新建 ”菜单后创建新文件时使用此 API。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl.h
DLL Shell32.dll