Partager via

Fonction ParseApplicationUserModelId (appmodel.h)

  • Article

Déconstruit un ID de modèle utilisateur d’application en son nom de famille de package et l’ID d’application relatif du package (PRAID).

Syntaxe

LONG ParseApplicationUserModelId(
  [in]            PCWSTR applicationUserModelId,
  [in, out]       UINT32 *packageFamilyNameLength,
  [out, optional] PWSTR  packageFamilyName,
  [in, out]       UINT32 *packageRelativeApplicationIdLength,
  [out, optional] PWSTR  packageRelativeApplicationId
);

Paramètres

[in] applicationUserModelId

Type : PCWSTR

ID du modèle utilisateur de l’application.

[in, out] packageFamilyNameLength

Type : UINT32*

Pointeur vers une variable qui contient le nombre de caractères (WCHARs) dans la chaîne de nom de famille de package, qui inclut la terminaison null.

Tout d’abord, vous passez la valeur NULL à packageFamilyName pour obtenir le nombre de caractères. Vous utilisez ce nombre pour allouer de l’espace mémoire pour packageFamilyName. Ensuite, vous transmettez l’adresse de cet espace mémoire pour remplir packageFamilyName.

[out, optional] packageFamilyName

Type : PWSTR

Pointeur vers l’espace mémoire qui reçoit la chaîne de nom de famille de package, qui inclut la fin null.

[in, out] packageRelativeApplicationIdLength

Type : UINT32*

Pointeur vers une variable qui contient le nombre de caractères (WCHARs) dans la chaîne d’ID d’application relative au package, qui inclut la terminaison null.

Tout d’abord, vous passez la valeur NULL à packageRelativeApplicationId pour obtenir le nombre de caractères. Vous utilisez ce nombre pour allouer de l’espace mémoire pour packageRelativeApplicationId. Ensuite, vous transmettez l’adresse de cet espace mémoire pour remplir packageRelativeApplicationId.

[out, optional] packageRelativeApplicationId

Type : PWSTR

Pointeur vers l’espace mémoire qui reçoit la chaîne d’ID d’application relative au package (PRAID), qui inclut la fin null.

Valeur retournée

Type : LONG

Si la fonction réussit, elle retourne ERROR_SUCCESS. Sinon, la fonction retourne un code d’erreur. Les codes d’erreur possibles sont les suivants.

Code de retour Description
ERROR_INVALID_PARAMETER
 Le paramètre applicationUserModelId n’est pas valide.
ERROR_INSUFFICIENT_BUFFER
 La mémoire tampon spécifiée par packageFamilyName ou packageRelativeApplicationId n’est pas assez grande pour contenir les données ; la taille de mémoire tampon requise, en WCHARs, est stockée dans la variable pointée par packageFamilyNameLength ou packageRelativeApplicationIdLength.

Configuration requise

   
Client minimal pris en charge Windows 8.1 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête appmodel.h
Bibliothèque Kernel32.lib
DLL Kernel32.dll