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

Требования

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

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

IApplicationDestinations

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