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