通过

IActiveDesktop：：AddDesktopItem 方法 (shlobj_core.h)

  • 项目

添加桌面项。

语法

HRESULT AddDesktopItem(
  [in] LPCCOMPONENT pcomp,
       DWORD        dwReserved
);

参数

[in] pcomp

类型： LPCCOMPONENT

指向 COMPONENT 结构的指针，该结构指定要添加的项。

dwReserved

类型：DWORD

保留。 必须设置为零。

返回值

类型： HRESULT

返回以下值之一。

返回代码 说明
E_FAIL
 无法添加桌面项，或者活动桌面上已存在桌面项的实例。
E_INVAILDARG
 一个或多个参数无效。
S_OK
 已成功添加桌面项。

注解

桌面项已添加到桌面，但它不会将其保存到注册表。 客户端应用程序必须单独调用 IActiveDesktop：：ApplyChanges 以更新注册表。

要求

要求 值
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h
DLL Shell32.dll (版本 4.71 或更高版本)

另请参阅

IActiveDesktop

使用活动桌面对象