Метод IApplicationDestinations::SetAppID (shobjidl_core.h)
Указывает уникальный идентификатор модели пользователя приложения (AppUserModelID) для приложения, из которого в списке переходов кнопки панели задач методы этого интерфейса будут удалять назначения. Этот метод является необязательным.
Синтаксис
HRESULT SetAppID(
[in] LPCWSTR pszAppID
);
Параметры
[in] pszAppID
Тип: LPCWSTR
Указатель на AppUserModelID процесса, кнопка панели задач которого получает список переходов.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Если приложение имеет явное значение AppUserModelID, этот метод необходимо вызвать перед вызовом RemoveAllDestinations или RemoveDestination.
После указания 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)