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::GetDesktopItem 和 IActiveDesktop::GetDesktopItemCount 方法枚举桌面项。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版、Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | shlobj_core.h |
DLL | Shell32.dll (版本 4.71 或更高版本) |