IActiveDesktop：：AddDesktopItemWithUI 方法 (shlobj_core.h)

  • 發行項

在顯示確認新增桌面專案、驗證安全性區域許可權，以及詢問使用者是否要建立訂用帳戶的使用者介面之後，將桌面專案新增至 Active Desktop。

語法

HRESULT AddDesktopItemWithUI(
  [in, optional] HWND        hwnd,
  [in]           LPCOMPONENT pcomp,
                 DWORD       dwReserved
);

參數

[in, optional] hwnd

類型： HWND

父視窗的句柄。 如果 為 NULL，則會根據對應的安全性區域許可權，新增桌面專案而不顯示任何使用者介面。 如需詳細資訊，請參閱 關於URL安全性區域。

[in] pcomp

類型： LPCOMPONENT

COMPONENT 結構的位址，其中包含要新增之桌面專案的詳細數據。

dwReserved

類型： DWORD

不帶正負號的長整數值，其中包含控制桌面專案新增方式的旗標。 可以是下列其中一個值。

DTI_ADDUI_DEFAULT

執行預設動作。 與使用零相同。

DTI_ADDUI_DISPSUBWIZARD

啟用訂閱精靈，讓使用者訂閱此桌面專案。

DTI_ADDUI_POSITIONITEM

指示系統查看傳遞至 COMPONENT 結構的 cpPos 成員的 COMPPOS 結構，以確保這些值在合理的限制內。 Internet Explorer 5 已新增此值。

傳回值

類型： HRESULT

傳回下列其中一個值。

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

備註

此方法會建立第二個 Active Desktop 實例來新增桌面專案，因此桌面專案不會出現在目前的 實例中。 應用程式必須在此 IActiveDesktop 介面上呼叫 IUnknown：：Release 方法，然後使用 CoCreateInstance 函式擷取具有新加入元件的 Active Desktop 物件。

規格需求

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

另請參閱

IActiveDesktop

使用 Active Desktop 物件