取得指定的桌面專案。
語法
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 版或更新版本) |