IActiveDesktop::GetDesktopItemByID 方法 (shlobj_core.h)

获取与给定标识匹配的桌面项。

语法

HRESULT GetDesktopItemByID(
            ULONG_PTR   dwID,
  [in, out] LPCOMPONENT pcomp,
            DWORD       dwReserved
);

参数

dwID

类型: ULONG_PTR

一个包含桌面项标识的无符号长整数值。

[in, out] pcomp

类型: LPCOMPONENT

检索到的桌面项的 COMPONENT 结构的地址。

dwReserved

类型:DWORD

保留。 必须设置为零。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

桌面项的标识在从 IActiveDesktop::GetDesktopItem 方法返回的 COMPONENT 结构的 dwID 成员中返回。 此标识仅在调用 IActiveDesktop::ApplyChanges 方法之前有效。 必须一致检索同一桌面项的应用程序应使用 IActiveDesktop::GetDesktopItemIActiveDesktop::GetDesktopItemCount 方法枚举桌面项。

要求

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

另请参阅

IActiveDesktop