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*

變數的指標，該變數包含 null 結束字元， (WCHARs) 的字元數。

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

[out, optional] packageFamilyName

類型： PWSTR

接收封裝系列名稱字串的記憶體空間指標，其中包含 null 結束字元。

[in, out] packageRelativeApplicationIdLength

類型： UINT32*

變數的指標，其中包含 null 結束字元 (WCHARs) 字串中的字元數。

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

[out, optional] packageRelativeApplicationId

類型： PWSTR

接收套件相對應用程式識別碼 (PRAID) 字串的記憶體空間指標，其中包含 null 結束字元。

傳回值

類型： LONG

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

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

規格需求

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