GetPackageInfo2, fonction (appmodel.h)

Article
02/23/2024

Obtient les informations de package pour le package spécifié, avec l’option permettant de spécifier le type de chemin d’accès au dossier à récupérer pour le package.

Syntaxe

LONG GetPackageInfo2(
  PACKAGE_INFO_REFERENCE packageInfoReference,
  const UINT32           flags,
  PackagePathType        packagePathType,
  UINT32                 *bufferLength,
  BYTE                   *buffer,
  UINT32                 *count
);

Paramètres

packageInfoReference

Type : PACKAGE_INFO_REFERENCE

Référence aux informations de package.

flags

Type : const UINT32

Constantes de package qui spécifient la façon dont les informations de package sont récupérées.

packagePathType

Type : PackagePathType

Indique le type de chemin d’accès du dossier à récupérer pour le package (le dossier d’installation d’origine ou le dossier mutable).

bufferLength

Type : UINT32*

En entrée, taille de la mémoire tampon, en octets. Lors de la sortie, taille des informations de package retournées, en octets.

buffer

Type : BYTE*

Informations sur le package, représentées sous la forme d’un tableau de structures PACKAGE_INFO .

count

Type : UINT32*

Nombre de packages dans la mémoire tampon.

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	La mémoire tampon n’est pas assez grande pour contenir les données. La taille requise est spécifiée par bufferLength.

Remarques

Le paramètre packagePathType est utile pour les applications qui utilisent l’extension windows.mutablePackageDirectories dans leur manifeste de package. Cette extension spécifie un dossier sous le chemin %ProgramFiles%\ModifiableWindowsApps où le contenu du dossier d’installation de l’application est projeté afin que les utilisateurs puissent modifier les fichiers d’installation. Cette fonctionnalité est actuellement disponible uniquement pour certains types de jeux PC de bureau publiés par Microsoft et nos partenaires, et elle permet à ces types de jeux de prendre en charge les mods.

Configuration requise

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