Функция FormatApplicationUserModelId (appmodel.h)

Статья
02/28/2024

Создает идентификатор модели пользователя приложения на основе имени семейства пакетов и идентификатора приложения относительно пакета (PRAID).

Синтаксис

LONG FormatApplicationUserModelId(
  [in]            PCWSTR packageFamilyName,
  [in]            PCWSTR packageRelativeApplicationId,
  [in, out]       UINT32 *applicationUserModelIdLength,
  [out, optional] PWSTR  applicationUserModelId
);

Параметры

[in] packageFamilyName

Тип: PCWSTR

Имя семейства пакетов.

[in] packageRelativeApplicationId

Тип: PCWSTR

Идентификатор приложения относительно пакета (PRAID).

[in, out] applicationUserModelIdLength

Тип: UINT32*

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

Сначала вы передаете значение NULLв applicationUserModelId , чтобы получить количество символов. Это число используется для выделения места в памяти для applicationUserModelId. Затем вы передаете адрес этого пространства памяти для заполнения applicationUserModelId.

[out, optional] applicationUserModelId

Тип: PWSTR

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

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

Тип: LONG

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

Код возврата	Описание
ERROR_INVALID_PARAMETER	Недопустимый параметр packageFamilyName или packageRelativeApplicationId .
ERROR_INSUFFICIENT_BUFFER	Буфер, заданный параметром applicationUserModelId , недостаточно велик для хранения данных; Требуемый размер буфера в WCHARхранится в переменной, на которую указывает applicationUserModelIdLength.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8.1 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	appmodel.h
Библиотека	Kernel32.lib
DLL	Kernel32.dll

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