GetCurrentPackageInfo2, fonction (appmodel.h)

Article
02/26/2024

Obtient les informations de package pour le processus appelant, avec la possibilité de spécifier le type de chemin d’accès au dossier à récupérer pour le package.

Syntaxe

LONG GetCurrentPackageInfo2(
  const UINT32    flags,
  PackagePathType packagePathType,
  UINT32          *bufferLength,
  BYTE            *buffer,
  UINT32          *count
);

Paramètres

flags

Type : const UINT32

Constantes de package qui spécifient la façon dont les informations de package sont récupérées. Les indicateurs PACKAGE_FILTER_* sont pris en charge.

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. En sortie, taille du tableau de structures retourné, 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 structures 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
APPMODEL_ERROR_NO_PACKAGE	Le processus n’a pas d’identité de package.
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