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 方法來列舉桌面專案。

規格需求

另請參閱

IActiveDesktop