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

デスクトップ項目を追加します。

構文

HRESULT AddDesktopItem(
  [in] LPCCOMPONENT pcomp,
       DWORD        dwReserved
);

[in] pcomp

種類: LPCCOMPONENT

追加する項目を指定する COMPONENT 構造体へのポインター。

dwReserved

型: DWORD

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

種類: HRESULT

次のいずれかの値を返します。

リターンコード	説明
E_FAIL	デスクトップ項目を追加できませんでした。または、デスクトップ項目のインスタンスが Active Desktop に既に存在します。
E_INVAILDARG	1 つ以上のパラメーターが無効でした。
S_OK	デスクトップ項目が正常に追加されました。

デスクトップ項目はデスクトップに追加されますが、レジストリには保存されません。レジストリを更新するには、クライアントアプリケーションで IActiveDesktop::ApplyChanges を個別に呼び出す必要があります。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h
[DLL]	Shell32.dll (バージョン 4.71 以降)