SHARD 枚举 (shlobj_core.h)

  • 项目

指示 SHAddToRecentDocs 在其 pv 参数中传递的数据的解释，以标识正在跟踪其使用情况统计信息的项。

语法

typedef enum {
  SHARD_PIDL,
  SHARD_PATHA,
  SHARD_PATHW,
  SHARD_APPIDINFO,
  SHARD_APPIDINFOIDLIST,
  SHARD_LINK,
  SHARD_APPIDINFOLINK,
  SHARD_SHELLITEM
} SHARD;

常量

 
SHARD_PIDL
pv 参数指向标识文档的文件对象的 PIDL。 不接受标识非文件对象的 PIDL。
SHARD_PATHA
pv 参数指向一个以 null 结尾的 ANSI 字符串，其中包含对象的路径和文件名。
SHARD_PATHW
pv 参数指向一个以 null 结尾的 Unicode 字符串，其中包含对象的路径和文件名。
SHARD_APPIDINFO
Windows 7 及更高版本。 pv 参数指向 SHARDAPPIDINFO 结构，该结构将标识项的 IShellItem 与 AppUserModelID 配对，该 AppUserModelID 与特定进程或应用程序相关联。
SHARD_APPIDINFOIDLIST
Windows 7 及更高版本。 pv 参数指向一个 SHARDAPPIDINFOIDLIST 结构，该结构将一个绝对 PIDL 配对，该 PIDL 使用 AppUserModelID 将其与特定进程或应用程序相关联。
SHARD_LINK
Windows 7 及更高版本。 pv 参数是指向 IShellLink 对象的接口指针。
SHARD_APPIDINFOLINK
Windows 7 及更高版本。 pv 参数指向 SHARDAPPIDINFOLINK 结构，该结构将标识项的 IShellLink 与将项与特定进程或应用程序关联的 AppUserModelID 配对。
SHARD_SHELLITEM
Windows 7 及更高版本。 pv 参数是指向 IShellItem 对象的接口指针。

注解

在 Windows 7 之前，SHARD_PIDL、SHARD_PATHA和SHARD_PATHW定义为单独的常量，而不是枚举成员。

通过 SHARD_LINK 或 SHARD_APPIDINFOLINK 提供 IShellLink 时，IShellLink 实例必须提供以下内容：

必须通过项目的 System.Title (PKEY_Title) 属性设置显示名称。 属性可以直接保存显示名称，也可以是间接字符串表示形式（如“@shell32.dll，-1324”）以使用存储的字符串。 间接字符串允许以用户所选语言显示项名称。

（可选）可以设置 IShellLink：：SetDescription) (说明字段，为跳转列表中的项提供自定义工具提示。

要求

   
最低受支持的客户端 Windows 2000 专业版、Windows XP、Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 shlobj_core.h (包括 Shlobj.h)

另请参阅

SHAddToRecentDocs