Метод 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::RemoveAllDestinations