Fonction FCIAddFile (fci.h)

Le fichier FCIAddFile ajoute un fichier à l’armoire en cours de construction.

Syntaxe

BOOL DIAMONDAPI FCIAddFile(
  [in] HFCI                 hfci,
  [in] LPSTR                pszSourceFile,
  [in] LPSTR                pszFileName,
  [in] BOOL                 fExecute,
  [in] PFNFCIGETNEXTCABINET pfnfcignc,
  [in] PFNFCISTATUS         pfnfcis,
  [in] PFNFCIGETOPENINFO    pfnfcigoi,
  [in] TCOMP                typeCompress
);

Paramètres

[in] hfci

Handle de contexte FCI valide retourné par la fonction FCICreate .

[in] pszSourceFile

Nom du fichier à ajouter ; cette valeur doit inclure des informations sur le chemin d’accès.

[in] pszFileName

Nom sous lequel stocker le fichier dans l’armoire.

[in] fExecute

Si la valeur est TRUE, le fichier est exécuté lors de son extraction.

[in] pfnfcignc

Pointeur vers une fonction de rappel définie par l’application pour obtenir des spécifications sur l’armoire suivante à créer. La fonction doit être déclarée à l’aide de la macro FNFCIGETNEXTCABINET .

[in] pfnfcis

Pointeur vers une fonction de rappel définie par l’application pour mettre à jour les informations de progression disponibles pour l’utilisateur. La fonction doit être déclarée à l’aide de la macro FNFCISTATUS .

[in] pfnfcigoi

Pointeur vers une fonction de rappel définie par l’application pour ouvrir un fichier et récupérer la date, l’heure et les attributs du fichier. La fonction doit être déclarée à l’aide de la macro FNFCIGETOPENINFO .

[in] typeCompress

Type de compression à utiliser.

Note Pour indiquer la compression LZX, utilisez la macro TCOMPfromLZXWindow .
 
Valeur Signification
tcompTYPE_NONE
0x0000
Aucune compression.
tcompTYPE_MSZIP
0x0001
Compression ZIP Microsoft.

Valeur retournée

Si la fonction réussit, elle retourne TRUE ; sinon, FALSE.

Les informations d’erreur étendues sont fournies dans la structure ERF utilisée pour créer le contexte FCI.

Notes

Lorsqu’il est défini, l’attribut _A_EXEC est ajouté à l’entrée de fichier dans le CAB. Ce mécanisme est utilisé dans certains exécutables à extraction automatique Microsoft et peut être utilisé à cet effet dans n’importe quelle application d’extraction personnalisée.

Spécifications

   
Plateforme cible Windows
En-tête fci.h
Bibliothèque Cabinet.lib
DLL Cabinet.dll

Voir aussi

FCICréer