GetPackagesByPackageFamily, fonction (appmodel.h)

  • Article

Obtient les packages avec le nom de famille spécifié pour l’utilisateur actuel.

Syntaxe

LONG GetPackagesByPackageFamily(
  [in]            PCWSTR packageFamilyName,
  [in, out]       UINT32 *count,
  [out, optional] PWSTR  *packageFullNames,
  [in, out]       UINT32 *bufferLength,
  [out, optional] WCHAR  *buffer
);

Paramètres

[in] packageFamilyName

Type : PCWSTR

Nom de la famille de packages.

[in, out] count

Type : UINT32*

Pointeur vers une variable qui contient le nombre de noms complets de package.

Tout d’abord, vous transmettez NULL à packageFullNames pour obtenir le nombre de noms complets du package. Vous utilisez ce nombre pour allouer de l’espace mémoire pour packageFullNames. Ensuite, vous transmettez l’adresse de ce numéro pour remplir packageFullNames.

[out, optional] packageFullNames

Type : PWSTR*

Pointeur vers les chaînes de noms complets de package.

[in, out] bufferLength

Type : UINT32*

Pointeur vers une variable qui contient le nombre de caractères dans la chaîne de noms complets de package.

Tout d’abord, vous passez null à la mémoire tampon pour obtenir le nombre de caractères. Vous utilisez ce nombre pour allouer de l’espace mémoire pour la mémoire tampon. Ensuite, vous transmettez l’adresse de ce numéro pour remplir la mémoire tampon.

[out, optional] buffer

Type : WCHAR*

Chaîne de caractères pour tous les noms complets du package.

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_INSUFFICIENT_BUFFER
 Une ou plusieurs mémoires tampons ne sont pas suffisamment grandes pour contenir les données. La taille requise est spécifiée par le nombre ou la mémoire tampon.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête appmodel.h
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

PackageNameAndPublisherIdFromFamilyName