Метод IApplicationDocumentLists::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 и не должны вызывать этот метод. В этом случае удостоверение приложения выводится при вызове метода IApplicationDocumentLists::GetList . Однако во избежание этих вычислений можно повысить производительность, поэтому приложениям, предоставляющим настраиваемые списки переходов, рекомендуется использовать явные идентификаторы AppUserModelID.

Требования


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

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

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

IApplicationDocumentLists

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

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