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

Статья
03/05/2024

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

Синтаксис

HRESULT AddDesktopItemWithUI(
  [in, optional] HWND        hwnd,
  [in]           LPCOMPONENT pcomp,
                 DWORD       dwReserved
);

Параметры

[in, optional] hwnd

Тип: HWND

Дескриптор родительского окна. Если значение РАВНО NULL, элемент рабочего стола добавляется без отображения пользовательского интерфейса в соответствии с соответствующими разрешениями зоны безопасности. Дополнительные сведения см. в разделе Сведения о зонах безопасности URL-адресов.

[in] pcomp

Тип: LPCOMPONENT

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

dwReserved

Тип: DWORD

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

DTI_ADDUI_DEFAULT

Выполнить действие по умолчанию. Идентично использованию нуля.

DTI_ADDUI_DISPSUBWIZARD

Активируйте мастер подписки, чтобы разрешить пользователю подписаться на этот элемент рабочего стола.

DTI_ADDUI_POSITIONITEM

Поручите системе просмотреть структуру COMPPOS , переданную члену cpPos структуры COMPONENT , чтобы убедиться, что значения находятся в разумных пределах. Это значение было добавлено для Internet Explorer 5.

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

Тип: HRESULT

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

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

Этот метод создает второй экземпляр Активного рабочего стола для добавления элемента рабочего стола, поэтому элемент рабочего стола не отображается в текущем экземпляре. Приложение должно вызвать метод IUnknown::Release в этом интерфейсе IActiveDesktop , а затем использовать функцию CoCreateInstance для получения объекта Active Desktop с добавленным компонентом.

Требования

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

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

IActiveDesktop

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

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