SHCreateDefaultPropertiesOp 函数 (shobjidl.h)

创建一个文件操作,该操作在尚未设置的 Shell 项上设置默认属性。

语法

SHSTDAPI SHCreateDefaultPropertiesOp(
  [in]  IShellItem     *psi,
  [out] IFileOperation **ppFileOp
);

参数

[in] psi

类型: IShellItem*

指向源 shell 项的指针。 请参阅 IShellItem

[out] ppFileOp

类型: IFileOperation**

IFileOperation 接口指针的地址。

返回值

类型: HRESULT

如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

要设置默认值的属性列表来自项目文件关联的 ProgID 下的 SetDefaultsFor 注册表项。 列表以 prop: 为前缀,包含属性的规范名称,用于设置默认值, prop:System.Author;System.Document.DateCreated例如 。 此列表的可能属性为 System.AuthorSystem.Document.DateCreatedSystem.Photo.DateTaken。 如果 ProgID 上不存在 SetDefaultsFor 条目,则此函数使用在 HKEY_CLASSES_ROOT\*SetDefaultsFor 条目上找到的默认值。

要求

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