Méthode IAppxPackageWriter::AddPayloadFile (appxpackaging.h)

Article
08/22/2023

Ajoute un nouveau fichier de charge utile au package d’application.

Syntaxe

HRESULT AddPayloadFile(
  [in] LPCWSTR                 fileName,
  [in] LPCWSTR                 contentType,
  [in] APPX_COMPRESSION_OPTION compressionOption,
  [in] IStream                 *inputStream
);

Paramètres

[in] fileName

Type : LPCWSTR

Nom du fichier de charge utile. Le chemin du nom de fichier doit être relatif à la racine du package.

[in] contentType

Type : LPCWSTR

Chaîne spécifiant le type de contenufileName.

[in] compressionOption

Type : APPX_COMPRESSION_OPTION

Type de compression à utiliser pour stocker fileName dans le package.

[in] inputStream

Type : IStream*

Un IStream fournissant le contenu de fileName. Le flux doit prendre en charge Read, Seek et Stat.

Valeur retournée

Type : HRESULT

Si la méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur qui inclut, sans s’y limiter, ceux du tableau suivant. Des codes OPC d’erreur, en plus de OPC_E_DUPLICATE_PART peuvent se produire. Si la méthode échoue, l’enregistreur de package se ferme dans un état d’échec et ne peut plus être utilisé.

Code de retour	Description
E_INVALIDARG	L’option de compression spécifiée par compressionOption ne fait pas partie des valeurs de l’énumération APPX_COMPRESSION_OPTION .
E_NOT_VALID_STATE	Le writer est fermé.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)	Le nom de fichier spécifié n’est pas un nom de fichier valide ou est un nom réservé pour un fichier d’empreinte.
OPC_E_DUPLICATE_PART	Le nom de fichier spécifié est déjà utilisé dans le package.

Remarques

Lorsque la méthode AddPayloadFile réussit, le contenu du fileName spécifié est écrit dans le package et une entrée correspondante est effectuée dans le mappage de blocs de package.

Note Les fichiers avec les noms de fichiers réservés suivants ne peuvent pas être ajoutés au package à l’aide de la méthode AddPayloadFile :

AppxManifest.xml, AppxBlockMap.xml, AppxStreamMap.xml et AppxSignature.p7x.

En outre, les fichiers avec les préfixes de dossier réservés suivants ne peuvent pas être ajoutés au package à l’aide de la méthode AddPayloadFile : \AppxMetadata\ et \Microsoft.System.Package.Metadata\.

Exemples

Pour obtenir un exemple, consultez Création d’un package d’application.

Configuration requise


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	appxpackaging.h

Voir aussi

APPX_COMPRESSION_OPTION

IAppxPackageWriter

Partager via