IActiveDesktop::ModifyDesktopItem メソッド (shlobj_core.h)
デスクトップ項目を変更します。
構文
HRESULT ModifyDesktopItem(
[in, out] LPCCOMPONENT pcomp,
DWORD dwFlags
);
パラメーター
[in, out] pcomp
種類: LPCCOMPONENT
変更を含む COMPONENT 構造体のアドレス。 構造体の wszSource メンバーに関連付けられているデスクトップ項目が変更されます。
dwFlags
型: DWORD
変更に使用されるフラグを含む符号なし long 整数値。 次のいずれかの値を指定できます。
COMP_ELEM_ALL
COMP_ELEM_CHECKED
COMP_ELEM_CURITEMSTATE
COMP_ELEM_FRIENDLYNAME
COMP_ELEM_NOSCROLL
COMP_ELEM_ORIGINAL_CSI
COMP_ELEM_POS_LEFT
COMP_ELEM_POS_TOP
COMP_ELEM_POS_ZINDEX
COMP_ELEM_RESTORED_CSI
COMP_ELEM_SIZE_HEIGHT
COMP_ELEM_SIZE_WIDTH
COMP_ELEM_SOURCE
COMP_ELEM_TYPE
戻り値
型: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
レジストリを更新するには、クライアント アプリケーションで IActiveDesktop::ApplyChanges を個別に呼び出す必要があります。 たとえば、フレンドリ名を変更するには、最初に COMPONENT の dwFlags メンバーで COMP_ELEM_FRIENDLYNAME または COMP_ELEM_ALLを指定してこの関数を呼び出します。 次に 、IActiveDesktop::ApplyChanges を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional、Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shlobj_core.h |
| [DLL] | Shlobj_core.h (バージョン 4.71 以降) |