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

Статья
08/26/2023

Добавляет элемент рабочего стола.

Синтаксис

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

Параметры

[in] pcomp

Тип: LPCCOMPONENT

Указатель на структуру COMPONENT , указывающую добавляемый элемент.

dwReserved

Тип: DWORD

Зарезервировано. Необходимо задать нулевое значение.

Возвращаемое значение

Тип: HRESULT

Возвращает одно из следующих значений.

Код возврата	Описание
E_FAIL	Не удалось добавить элемент рабочего стола, или экземпляр элемента рабочего стола уже существует на активном рабочем столе.
E_INVAILDARG	Один или несколько параметров были недопустимы.
S_OK	Элемент рабочего стола успешно добавлен.

Элемент рабочего стола добавляется на рабочий стол, но не сохраняется в реестре. Клиентское приложение должно вызывать IActiveDesktop::ApplyChanges отдельно, чтобы обновить реестр.

Требования

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

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

IActiveDesktop

Использование объекта Active Desktop

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