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

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

  • Статья

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

Синтаксис

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