Функция SetCurrentProcessExplicitAppUserModelID (shobjidl_core.h)

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

Синтаксис

SHSTDAPI SetCurrentProcessExplicitAppUserModelID(
  [in] PCWSTR AppID
);

Параметры

[in] AppID

Тип: PCWSTR

Указатель на AppUserModelID, назначаемого текущему процессу.

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

Тип: HRESULT

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод должен вызываться во время начальной процедуры запуска приложения, прежде чем приложение представит какой-либо пользовательский интерфейс или сделает любые манипуляции с его Списки перехода. Сюда входит любой вызов SHAddToRecentDocs.

Требования

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

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

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

GetCurrentProcessExplicitAppUserModelID

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