Fonction FindPackagesByPackageFamily (appmodel.h)

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

Syntaxe

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

Paramètres

[in] packageFamilyName

Type : PCWSTR

Nom de la famille de packages.

[in] packageFilters

Type : UINT32

Constantes de package qui spécifient la façon dont les informations de package sont récupérées. Toutes les constantes de package à l’exception des PACKAGE_FILTER_ALL_LOADED sont prises en charge.

[in, out] count

Type : UINT32*

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

Tout d’abord, vous passez null à packageFullNames pour obtenir le nombre de noms complets de package trouvés. Vous utilisez ce nombre pour allouer de l’espace mémoire pour packageFullNames. Ensuite, vous transmettez l’adresse de cet espace mémoire pour remplir packageFullNames.

[out, optional] packageFullNames

Type : PWSTR*

Pointeur vers l’espace mémoire qui reçoit les chaînes de noms complets de package trouvés.

[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 passez l’adresse de cet espace mémoire pour remplir la mémoire tampon.

[out, optional] buffer

Type : WCHAR*

Pointeur vers l’espace mémoire qui reçoit la chaîne de caractères pour tous les noms complets du package.

[out, optional] packageProperties

Type : UINT32*

Pointeur vers l’espace mémoire qui reçoit les propriétés du package pour tous les packages trouvés.

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.1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	appmodel.h
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll