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

傳回下列其中一個值。

傳回碼 Description
E_FAIL
 無法在使用中桌面上新增桌面專案或桌面項目的實例。
E_INVAILDARG
 一或多個參數無效。
S_OK
 如果已設定ADDURL_SILENT旗標，則已成功新增桌面專案，或已存在於作用中桌面上。 否則，已成功新增桌面專案。

備註

根據預設，此方法會顯示一些使用者介面，然後將桌面專案新增至 Active Desktop。 如同 IActiveDesktop：：AddDesktopItem，用戶端應用程式必須呼叫 IActiveDesktop：：ApplyChanges ，才能將變更儲存至登錄。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 shlobj_core.h
Dll Shell32.dll (4.71 版或更新版本)

另請參閱

IActiveDesktop

使用 Active Desktop 物件