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*

變數的指標，其中包含 null 終止符 (應用程式使用者模型識別符字串中的 WCHAR) 字元數。

首先，您會將 NULL 傳遞至 applicationUserModelId 以取得字元數。 您可以使用這個數位來配置 applicationUserModelId 的記憶體空間。 然後，您會傳遞此記憶體空間的位址來填滿 applicationUserModelId。

[out, optional] applicationUserModelId

類型： PWSTR

接收應用程式使用者模型識別符字串的記憶體空間指標，其中包含Null終止符。

傳回值

類型： LONG

如果函式成功，它會傳回 ERROR_SUCCESS。 否則，函式會傳回錯誤碼。 可能的錯誤碼包括下列專案。

傳回碼	Description
ERROR_INVALID_PARAMETER	packageFamilyName 或 packageRelativeApplicationId 參數無效。
ERROR_INSUFFICIENT_BUFFER	applicationUserModelId 指定的緩衝區不夠大，無法保存數據;必要的緩衝區大小在 WCHARs 中儲存在 applicationUserModelIdLength 所指向的變數中。

規格需求

需求	值
最低支援的用戶端	Windows 8.1 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2012 R2 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	appmodel.h
程式庫	Kernel32.lib
DLL	Kernel32.dll