IActiveDesktop::GetDesktopItemByID メソッド (shlobj_core.h)

指定した ID に一致するデスクトップ項目を取得します。

構文

HRESULT GetDesktopItemByID(
            ULONG_PTR   dwID,
  [in, out] LPCOMPONENT pcomp,
            DWORD       dwReserved
);

パラメーター

dwID

種類: ULONG_PTR

デスクトップアイテムの識別情報を含む符号なし long 整数値。

[in, out] pcomp

種類: LPCOMPONENT

取得したデスクトップ項目の COMPONENT 構造体のアドレス。

dwReserved

型: DWORD

予約済み。 0 に設定する必要があります。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

デスクトップ項目の ID は、IActiveDesktop::GetDesktopItem メソッドから返される COMPONENT 構造体の dwID メンバーで返されます。 この識別は、 IActiveDesktop::ApplyChanges メソッドが呼び出されるまで有効です。 同じデスクトップ項目を一貫して取得する必要があるアプリケーションでは、IActiveDesktop::GetDesktopItem メソッドと IActiveDesktop::GetDesktopItemCount メソッドを使用してデスクトップ項目を列挙する必要があります。

要件

こちらもご覧ください

IActiveDesktop