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

Статья
08/26/2023

Указывает уникальный идентификатор модели пользователя приложения (AppUserModelID) для приложения, из которого в списке переходов кнопки панели задач методы этого интерфейса будут удалять назначения. Этот метод является необязательным.

Синтаксис

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

Параметры

[in] pszAppID

Тип: LPCWSTR

Указатель на AppUserModelID процесса, кнопка панели задач которого получает список переходов.

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

Тип: HRESULT

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

После указания AppUserModelID с помощью метода SetAppID объекта AppUserModelID сохраняется в объекте в течение времени существования этого объекта, при условии, что он не перезаписывается другим вызовом SetAppID.

Некоторые приложения не объявляют явный AppUserModelID и не должны вызывать этот метод. В этом случае удостоверение приложения выводится при вызове метода IApplicationDestinations::RemoveDestination или IApplicationDestinations::RemoveAllDestinations . Однако во избежание этих вычислений есть преимущество производительности, поэтому приложениям, предоставляющим настраиваемые Списки перехода, рекомендуется использовать явные идентификаторы AppUserModelID.

Требования

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

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

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

IApplicationDestinations

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

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