GetStagedPackagePathByFullName2, fonction (appmodel.h)

  • Article

Obtient le chemin d’accès du package intermédiaire 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 GetStagedPackagePathByFullName2(
  PCWSTR          packageFullName,
  PackagePathType packagePathType,
  UINT32          *pathLength,
  PWSTR           path
);

Paramètres

packageFullName

Type : PCWSTR

Nom complet du package intermédiaire.

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).

pathLength

Type : UINT32*

Pointeur vers une variable qui contient le nombre de caractères (WCHAR) dans la chaîne de chemin d’accès du package, qui inclut le terminateur Null.

Tout d’abord, vous passez null au chemin d’accès pour obtenir le nombre de caractères. Vous utilisez ce nombre pour allouer de l’espace mémoire au chemin d’accès. Ensuite, vous passez l’adresse de cet espace mémoire pour remplir le chemin.

path

Type : PWSTR

Pointeur vers l’espace mémoire qui reçoit la chaîne de chemin d’accès du package, qui inclut le terminateur Null.

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 spécifiée par le chemin d’accès n’est pas suffisamment grande pour contenir les données. La taille requise est spécifiée par pathLength.

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

Voir aussi

GetStagedPackagePathByFullName