指示 SHAddToRecentDocs 在其 pv 参数中传递的数据的解释,以标识要跟踪其使用情况统计信息的项。
Syntax
typedef enum {
SHARD_PIDL,
SHARD_PATHA,
SHARD_PATHW,
SHARD_APPIDINFO,
SHARD_APPIDINFOIDLIST,
SHARD_LINK,
SHARD_APPIDINFOLINK,
SHARD_SHELLITEM
} SHARD;
Constants
SHARD_PIDLpv 参数指向标识文档的文件对象的 PIDL。 不接受标识非文件对象的 PIDL。 |
SHARD_PATHApv 参数指向具有对象路径和文件名的以 null 结尾的 ANSI 字符串。 |
SHARD_PATHWpv 参数指向具有对象路径和文件名的以 null 结尾的 Unicode 字符串。 |
SHARD_APPIDINFOWindows 7 及更高版本。 pv 参数指向一个 SHARDAPPIDINFO 结构,该结构将 IShellItem 配对,该结构使用将项与特定进程或应用程序关联的 AppUserModelID 进行标识。 |
SHARD_APPIDINFOIDLISTWindows 7 及更高版本。 pv 参数指向一个 SHARDAPPIDINFOIDLIST 结构,该结构将一个绝对 PIDL 配对,该结构将项与一个 AppUserModelID 关联到特定进程或应用程序。 |
SHARD_LINKWindows 7 及更高版本。 pv 参数是指向 IShellLink 对象的接口指针。 |
SHARD_APPIDINFOLINKWindows 7 及更高版本。 pv 参数指向 SHARDAPPIDINFOLINK 结构,该结构将 IShellLink 与将项与特定进程或应用程序关联的 AppUserModelID 进行标识。 |
SHARD_SHELLITEMWindows 7 及更高版本。 pv 参数是指向 IShellItem 对象的接口指针。 |
注解
在 Windows 7 之前,SHARD_PIDL、SHARD_PATHA和SHARD_PATHW定义为单个常量,而不是枚举成员。
通过SHARD_LINK或SHARD_APPIDINFOLINK提供 IShellLink 时,IShellLink 实例必须提供以下内容:
- PIDL(IShellLink::SetIDList)或目标路径(IShellLink::SetPath 或 IShellLink::SetRelativePath)
- 命令行参数 (IShellLink::SetArguments)
- 图标位置 (IShellLink::SetIconLocation)
(可选)可以设置说明字段(IShellLink::SetDescription),为跳转列表中的项提供自定义工具提示。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows 2000 Professional、Windows XP、Windows 7 [仅限桌面应用] |
| 支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
| Header | shlobj_core.h (包括 Shlobj.h) |