通过

IActiveDesktop：：AddUrl 方法 (shlobj_core.h)

  • 项目

添加与指定 URL 关联的桌面项。

语法

HRESULT AddUrl(
  [in, optional] HWND        hwnd,
  [in]           PCWSTR      pszSource,
  [in]           LPCOMPONENT pcomp,
                 DWORD       dwFlags
);

参数

[in, optional] hwnd

类型：HWND

用户界面的父窗口的句柄。

[in] pszSource

类型： PCWSTR

指向包含桌面项 URL 的字符串的指针。

[in] pcomp

类型： LPCOMPONENT

指向 COMPONENT 结构的指针，该 结构 包含要添加的桌面项的详细信息。

dwFlags

类型：DWORD

控制此方法的无符号长整数值。 可以设置为 ADDURL_SILENT以添加桌面项而不显示任何用户界面。

返回值

类型： HRESULT

返回以下值之一。

返回代码 说明
E_FAIL
 无法添加桌面项，或者活动桌面上已存在桌面项的实例。
E_INVAILDARG
 一个或多个参数无效。
S_OK
 如果已设置ADDURL_SILENT标志，则表示已成功添加桌面项，或者它已存在于活动桌面上。 否则，已成功添加桌面项。

注解

默认情况下，此方法将显示一些用户界面，然后将桌面项添加到活动桌面。 与 IActiveDesktop：：AddDesktopItem 一样，客户端应用程序必须调用 IActiveDesktop：：ApplyChanges 才能将更改保存到注册表。

要求

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

另请参阅

IActiveDesktop

使用 Active Desktop 对象