Метод ICustomDestinationList::D eleteList (shobjidl_core.h)

Удаляет пользовательский список переходов для указанного приложения.

Синтаксис

HRESULT DeleteList(
  [in] LPCWSTR pszAppID
);

Параметры

[in] pszAppID

Тип: LPCWSTR

Указатель на AppUserModelID процесса, кнопка панели задач которого отображает пользовательский список переходов. В бета-версии Windows 7 этот идентификатор AppUserModelID должен быть явно указан, так как этот метод предназначен для вызова из средства удаления, которое выполняется в отдельном процессе. Так как он находится в отдельном процессе, система не может надежно вывести AppUserModelID. Ожидается, что это ограничение будет удалено в более поздних выпусках.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод должен вызываться в нескольких случаях, в том числе:

  • При удалении приложения.
  • Когда пользователь очищает журнал из приложения.
  • Когда пользователь отключает отслеживание назначения на страницах параметров или параметров приложения.
Этот метод не следует вызывать, когда приложение обновляет пользовательский список назначения. Он используется только для полной очистки списка во время операции удаления или, если приложение предоставляет пользователю возможность отключить список.

После удаления пользовательского списка переходов отображается стандартный список переходов, созданный на основе системных данных для недавно использовавшихся элементов. Если такие данные не были собраны или данные были удалены с помощью RemoveAllDestinations, список переходов может содержать только минимальное содержимое: стандартные задачи для закрепления или открепления, запуска нового экземпляра приложения или закрытия окон.

Требования

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

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

Идентификаторы моделей пользователей приложений (AppUserModelID)

ICustomDestinationList

ICustomDestinationList::SetAppID

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