FormatApplicationUserModelId 函数 (appmodel.h)

从包系列名称和包相对应用程序 ID (PRAID) 构造应用程序用户模型 ID。

语法

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

参数

[in] packageFamilyName

类型： PCWSTR

包系列名称。

[in] packageRelativeApplicationId

类型： PCWSTR

相对于包的应用 ID (PRAID) 。

[in, out] applicationUserModelIdLength

类型： UINT32*

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

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

[out, optional] applicationUserModelId

类型： PWSTR

指向接收应用用户模型 ID 字符串（包括 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
标头	appmodel.h
Library	Kernel32.lib
DLL	Kernel32.dll