ParseApplicationUserModelId 函数 (appmodel.h)

  • 项目

将应用程序用户模型 ID 解构为其包系列名称和包相对应用程序 ID (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

应用用户模型 ID。

[in, out] packageFamilyNameLength

类型： UINT32*

指向变量的指针，该变量保存包系列名称字符串中 (WCHAR) 的字符数，其中包括 null 终止符。

首先，将 NULL 传递给 packageFamilyName 以获取字符数。 使用此数字为 packageFamilyName 分配内存空间。 然后传递此内存空间的地址以填充 packageFamilyName。

[out, optional] packageFamilyName

类型： PWSTR

一个指向内存空间的指针，该内存空间接收包系列名称字符串，其中包括 null 终止符。

[in, out] packageRelativeApplicationIdLength

类型： UINT32*

指向变量的指针，该变量保存包相对应用 ID 字符串中 WCHAR) 字符数 (，其中包括 null 终止符。

首先，将 NULL 传递给 packageRelativeApplicationId 以获取字符数。 使用此数字为 packageRelativeApplicationId 分配内存空间。 然后传递此内存空间的地址以填充 packageRelativeApplicationId。

[out, optional] packageRelativeApplicationId

类型： PWSTR

指向内存空间的指针，该内存空间接收包相对应用 ID (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
标头 appmodel.h
Library Kernel32.lib
DLL Kernel32.dll