Partager via

Fonction FormatApplicationUserModelId (appmodel.h)

  • Article

Construit un ID de modèle utilisateur d’application à partir du nom de famille de package et de l’ID d’application relatif (PRAID) du package.

Syntaxe

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

Paramètres

[in] packageFamilyName

Type : PCWSTR

Nom de la famille de package.

[in] packageRelativeApplicationId

Type : PCWSTR

ID d’application relatif au package (PRAID).

[in, out] applicationUserModelIdLength

Type : UINT32*

Pointeur vers une variable qui contient le nombre de caractères (WCHARs) dans la chaîne d’ID du modèle utilisateur de l’application, qui inclut la fin null.

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

[out, optional] applicationUserModelId

Type : PWSTR

Pointeur vers l’espace mémoire qui reçoit la chaîne d’ID de modèle utilisateur de l’application, 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 packageFamilyName ou packageRelativeApplicationId n’est pas valide.
ERROR_INSUFFICIENT_BUFFER
 La mémoire tampon spécifiée par applicationUserModelId n’est pas assez grande pour contenir les données ; la taille de mémoire tampon requise, dans WCHARs, est stockée dans la variable pointée par applicationUserModelIdLength.

Configuration requise

Condition requise Valeur
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