IActiveDesktop::GetDesktopItem メソッド (shlobj_core.h)
指定したデスクトップ項目を取得します。
構文
HRESULT GetDesktopItem(
int nComponent,
[in, out] LPCOMPONENT pcomp,
DWORD dwReserved
);
パラメーター
nComponent
型: int
デスクトップアイテムのインデックスを含む符号なし long 整数値。 インデックス値は 0 から始まります。 IActiveDesktop::GetDesktopItemCount を使用して、デスクトップアイテムの合計数のカウントを取得します。
[in, out] pcomp
種類: LPCOMPONENT
取得したデスクトップ項目の COMPONENT 構造体のアドレス。
dwReserved
型: DWORD
予約済み。 0 に設定する必要があります。
戻り値
型: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
デスクトップ項目が Active Desktop に追加および削除されると、インデックス値が変更されます。 アプリケーションでは、インデックス値が常に特定のデスクトップ項目に関連付けられるとは想定できません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional、Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shlobj_core.h |
| [DLL] | Shell32.dll (バージョン 4.71 以降) |