表示 SHAddToRecentDocs 在其 pv 參數中傳遞的資料,以識別正在追蹤使用統計的項目的解讀。
語法
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-terminaled 的 ANSI 字串,包含物件的路徑與檔案名稱。 |
SHARD_PATHWpv 參數指向一個 null 終止的 Unicode 字串,該字串包含物件的路徑與檔案名稱。 |
SHARD_APPIDINFOWindows 7 及以後版本。 pv 參數指向一個 SHARDAPPIDINFO 結構,該結構將一個識別該項目的 IShellItem 與一個將該項目關聯到特定程序或應用程式的 AppUserModelID 配對。 |
SHARD_APPIDINFOIDLISTWindows 7 及以後版本。 pv 參數指向一個 SHARDAPPIDINFOIDLIST 結構,該結構將一個絕對 PIDL 配對,該 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 專業版、Windows XP、Windows 7 [僅限桌面應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| Header | shlobj_core.h(包括 Shlobj.h) |