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


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

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

Синтаксис

SHSTDAPI GetCurrentProcessExplicitAppUserModelID(
  [out] PWSTR *AppID
);

Параметры

[out] AppID

Тип: PWSTR*

Указатель, получающий адрес Идентификатора AppUserModelID, назначенного процессу. Вызывающий объект отвечает за освобождение этой строки с помощью CoTaskMemFree , когда она больше не нужна.

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

Тип: HRESULT

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

Комментарии

Идентификатор AppUserModelID, полученный этой функцией, был задан ранее с помощью SetCurrentProcessExplicitAppUserModelID.

Приложение может получить только явно заданный идентификатор AppUserModelID. Не удается получить идентификаторы AppUserModel, назначаемые системой по умолчанию. Если приложению требуется знание идентификатора AppUserModelID, он должен быть задан явным образом.

Требования

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

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

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

IObjectWithAppUserModelID::GetAppID

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