Функция FormatApplicationUserModelId (appmodel.h)
Создает идентификатор модели пользователя приложения на основе имени семейства пакетов и идентификатора приложения относительно пакета (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. В противном случае функция возвращает код ошибки. Возможные коды ошибок включают следующие.
Код возврата | Описание |
---|---|
|
Недопустимый параметр packageFamilyName или packageRelativeApplicationId . |
|
Буфер, заданный параметром applicationUserModelId , недостаточно велик для хранения данных; Требуемый размер буфера в WCHARхранится в переменной, на которую указывает applicationUserModelIdLength. |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 8.1 [классические приложения | Приложения UWP] |
Минимальная версия сервера | Windows Server 2012 R2 [классические приложения | Приложения UWP] |
Целевая платформа | Windows |
Header | appmodel.h |
Библиотека | Kernel32.lib |
DLL | Kernel32.dll |