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


Метод IApplicationDestinations::RemoveDestination (shobjidl_core.h)

Удаляет одно назначение из категорий Последние и Частые в списке переходов.

Синтаксис

HRESULT RemoveDestination(
  [in] IUnknown *punk
);

Параметры

[in] punk

Тип: IUnknown*

Указатель на IShellItem или IShellLink , представляющий удаляемую точку назначения.

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

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения, или значение стандартной ошибки COM в противном случае. Если объект, на который указывает punk , не является IShellItem или IShellLink, метод возвращает E_INVALIDARG.

Комментарии

Назначение может отображаться в категориях Последние и Частые . В этом случае этот метод удаляет назначение из обеих категорий.

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

Приложение может вызвать RemoveDestination , не зная, находится ли элемент, на который указывает punk , в настоящее время в списке. Если в элементе отсутствуют данные (в этом случае он отсутствует в списке Последние или Частые ), этот метод не выполняет никаких действий и возвращает S_OK.

Если приложение имеет явный идентификатор модели пользователя приложения (AppUserModelID), перед вызовом этого метода необходимо вызвать IApplicationDestinations::SetAppID .

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)
Библиотека Shell32.lib
DLL Shell32.dll (версия 6.1 или более поздняя)

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

IApplicationDestinations

IApplicationDestinations::RemoveAllDestinations

IApplicationDestinations::SetAppID

Расширения панели задач