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

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

  • Статья

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

Синтаксис

LONG ParseApplicationUserModelId(
  [in]            PCWSTR applicationUserModelId,
  [in, out]       UINT32 *packageFamilyNameLength,
  [out, optional] PWSTR  packageFamilyName,
  [in, out]       UINT32 *packageRelativeApplicationIdLength,
  [out, optional] PWSTR  packageRelativeApplicationId
);

Параметры

[in] applicationUserModelId

Тип: PCWSTR

Идентификатор модели пользователя приложения.

[in, out] packageFamilyNameLength

Тип: UINT32*

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

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

[out, optional] packageFamilyName

Тип: PWSTR

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

[in, out] packageRelativeApplicationIdLength

Тип: UINT32*

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

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

[out, optional] packageRelativeApplicationId

Тип: PWSTR

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

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

Тип: LONG

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

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

Требования

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