添加桌面项。
语法
HRESULT AddDesktopItem(
[in] LPCCOMPONENT pcomp,
DWORD dwReserved
);
参数
[in] pcomp
类型: LPCCOMPONENT
指向 COMPONENT 结构的指针,该结构指定要添加的项。
dwReserved
类型:DWORD
保留。 必须设置为零。
返回值
类型: HRESULT
返回以下值之一。
| 返回代码 | 说明 |
|---|---|
|
无法添加桌面项,或者活动桌面上已存在桌面项的实例。 |
|
一个或多个参数无效。 |
|
已成功添加桌面项。 |
注解
桌面项已添加到桌面,但它不会将其保存到注册表。 客户端应用程序必须单独调用 IActiveDesktop::ApplyChanges 以更新注册表。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 专业版、Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | shlobj_core.h |
| DLL | Shell32.dll (版本 4.71 或更高版本) |