IActiveDesktop：：ModifyDesktopItem 方法 (shlobj_core.h)

项目
03/05/2024

修改桌面项。

语法

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 或更高版本)

另请参阅

IActiveDesktop

通过