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

  • Статья

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

Синтаксис

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

Параметры

[in] pszAppID

Тип: LPCWSTR

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

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

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения, или значение ошибки в противном случае, включая следующее:

Код возврата Описание
E_UNEXPECTED
 Этот метод был вызван после ICustomDestinationList::BeginList. Процесс создания списка уже выполняется с определенным AppUserModelID, выведенным системой или заданным посредством вызова SetAppID перед вызовом BeginList. После выполнения операции создания списка идентификатор AppUserModelID нельзя изменить до вызова CommitList или AbortList .

Комментарии

Если приложение имеет явное значение AppUserModelID, необходимо вызвать SetAppID перед вызовом ICustomDestinationList::BeginList или ICustomDestinationList::GetRemovedDestinations.

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

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

Требования

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

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

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

ICustomDestinationList

SetCurrentProcessExplicitAppUserModelID

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