SHARD 枚举 (shlobj_core.h)

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

Syntax

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

Constants

 
SHARD_PIDL
pv 参数指向标识文档的文件对象的 PIDL。 不接受标识非文件对象的 PIDL。
SHARD_PATHA
pv 参数指向具有对象路径和文件名的以 null 结尾的 ANSI 字符串。
SHARD_PATHW
pv 参数指向具有对象路径和文件名的以 null 结尾的 Unicode 字符串。
SHARD_APPIDINFO
Windows 7 及更高版本pv 参数指向一个 SHARDAPPIDINFO 结构,该结构将 IShellItem 配对,该结构使用将项与特定进程或应用程序关联的 AppUserModelID 进行标识。
SHARD_APPIDINFOIDLIST
Windows 7 及更高版本pv 参数指向一个 SHARDAPPIDINFOIDLIST 结构,该结构将一个绝对 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_LINKSHARD_APPIDINFOLINK提供 IShellLink 时,IShellLink 实例必须提供以下内容:

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

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

要求

Requirement 价值
最低支持的客户端 Windows 2000 Professional、Windows XP、Windows 7 [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
Header shlobj_core.h (包括 Shlobj.h)

另请参阅

SHAddToRecentDocs