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 ターミネータが含まれます。

まず、packageFamilyName にNULL を渡して文字数を取得します。 packageFamilyName にメモリ領域を割り当てるには、この番号を使用します。 次に、このメモリ領域のアドレスを渡して packageFamilyName を埋めます。

[out, optional] packageFamilyName

種類: PWSTR

null ターミネータを含むパッケージ ファミリ名の文字列を受け取るメモリ領域へのポインター。

[in, out] packageRelativeApplicationIdLength

型: UINT32*

null ターミネータを含む、パッケージ相対アプリ ID 文字列内の文字数 (WCHAR) を保持する変数へのポインター。

まず、packageRelativeApplicationId に NULL を渡して文字数を取得します。 packageRelativeApplicationId のメモリ領域を割り当てるには、この番号を使用します。 次に、このメモリ領域のアドレスを渡して packageRelativeApplicationId を埋めます。

[out, optional] packageRelativeApplicationId

種類: PWSTR

null ターミネータを含むパッケージ相対アプリ ID (PRAID) 文字列を受け取るメモリ領域へのポインター。

戻り値

型: LONG

関数が成功すると、 ERROR_SUCCESSが返されます。 それ以外の場合、関数はエラー コードを返します。 考えられるエラー コードは次のとおりです。

リターン コード	説明
ERROR_INVALID_PARAMETER	applicationUserModelId パラメーターが無効です。
ERROR_INSUFFICIENT_BUFFER	packageFamilyName または packageRelativeApplicationId で指定されたバッファーは、データを保持するのに十分な大きさではありません。必要なバッファー サイズ (WCHARs) は、packageFamilyNameLength または packageRelativeApplicationIdLength が指す変数に格納されます。

要件

サポートされている最小のクライアント	Windows 8.1 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2012 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	appmodel.h
Library	Kernel32.lib
[DLL]	Kernel32.dll