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

Требования

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

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

IApplicationDocumentLists

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