GetPackagesByPackageFamily, fonction (appmodel.h)

Article
02/28/2024

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

Partager via