IActiveDesktop::GetDesktopItem 方法 (shlobj_core.h)

获取指定的桌面项。

语法

HRESULT GetDesktopItem(
            int         nComponent,
  [in, out] LPCOMPONENT pcomp,
            DWORD       dwReserved
);

参数

nComponent

类型: int

一个包含桌面项索引的无符号长整数值。 索引值从零开始。 使用 IActiveDesktop::GetDesktopItemCount 检索桌面项目总数的计数。

[in, out] pcomp

类型: LPCOMPONENT

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

dwReserved

类型:DWORD

保留。 必须设置为零。

返回值

类型: HRESULT

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

注解

索引值将随着桌面项的添加和删除而更改。 应用程序不能假定索引值将始终与特定桌面项相关联。

要求

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

另请参阅

IActiveDesktop