Метод IActiveDesktop::ModifyDesktopItem (shlobj_core.h)

Статья
03/05/2024

Изменяет элемент рабочего стола.

Синтаксис

HRESULT ModifyDesktopItem(
  [in, out] LPCCOMPONENT pcomp,
            DWORD        dwFlags
);

Параметры

[in, out] pcomp

Тип: LPCCOMPONENT

Адрес структуры COMPONENT , содержащей изменения. Элемент рабочего стола, связанный с членом wszSource структуры, будет изменен.

dwFlags

Тип: DWORD

Длинное целое число без знака, содержащее флаги, используемые для изменения. Это может быть одно из следующих значений.

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 отдельно, чтобы обновить реестр. Например, чтобы изменить понятное имя, сначала вызовите эту функцию с помощью COMP_ELEM_FRIENDLYNAME или COMP_ELEM_ALL в элементе dwFlagsкомпонента COMPONENT. Затем вызовите IActiveDesktop::ApplyChanges.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h
DLL	Shlobj_core.h (версия 4.71 или более поздняя)

См. также раздел

IActiveDesktop

Поделиться через