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 方法之前，此識別才有效。 必須一致地擷取相同桌面專案的應用程式應該使用IActiveDesktopItem和 IActiveDesktop：：GetDesktopItemCount 方法來列舉桌面專案。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 shlobj_core.h
Dll Shell32.dll (4.71 版或更新版本)

另請參閱

IActiveDesktop