修改桌面專案。
語法
HRESULT ModifyDesktopItem(
[in, out] LPCCOMPONENT pcomp,
DWORD dwFlags
);
參數
[in, out] pcomp
類型： LPCCOMPONENT
包含修改之 COMPONENT 結構的位址。 將會修改與結構 wszSource 成員相關聯的桌面專案。
dwFlags
類型： DWORD
未帶正負號的長整數值，其中包含用於修改的旗標。 這可以是下列其中一個值。
COMP_ELEM_ALL
COMP_ELEM_CHECKED
COMP_ELEM_CURITEMSTATE
COMP_ELEM_FRIENDLYNAME
COMP_ELEM_NOSCROLL
COMP_ELEM_ORIGINAL_CSI
COMP_ELEM_POS_LEFT
COMP_ELEM_POS_TOP
COMP_ELEM_POS_ZINDEX
COMP_ELEM_RESTORED_CSI
COMP_ELEM_SIZE_HEIGHT
COMP_ELEM_SIZE_WIDTH
COMP_ELEM_SOURCE
COMP_ELEM_TYPE
傳回值
類型： HRESULT
如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
用戶端應用程式必須個別呼叫 IActiveDesktop：：ApplyChanges ，才能更新登錄。 例如，若要變更易記名稱，請先在 COMPONENT 的 dwFlags 成員中使用 COMP_ELEM_FRIENDLYNAME 或 COMP_ELEM_ALL 呼叫此函式。 然後呼叫 IActiveDesktop：：ApplyChanges。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版、Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | shlobj_core.h |
| Dll | Shlobj_core.h (4.71 版或更新版本) |