zip_file_set_encryption |
Fixe le chiffrement du fichier |
|---|---|
| libzip | |
Syntaxe
| int zip_file_set_encryption(zip_t *archive, zip_uint64_t index, zip_uint16_t method, const char *password); |
Retour
En cas de réussite, 0 est renvoyé. Sinon, -1 est renvoyé et les informations d'erreur dans l'archive sont définies pour indiquer l'erreur.
Description
Cette fonction permet de définir la méthode de chiffrement pour un fichier dans l'archive ZIP.
Remarques
- La fonction zip_file_set_encryption() définit la méthode de chiffrement du fichier à la position index dans l'archive zip sur method en utilisant le mot de passe password. La méthode est la même que celle renvoyée par zip_stat(). Pour le paramètre method, seules les valeurs suivantes sont actuellement prises en charge :
- Si le mot de passe est NULL, le mot de passe par défaut fourni par zip_set_default_password() est utilisé.
- La méthode de chiffrement actuelle pour un fichier dans une archive zip peut être déterminée à l'aide de zip_stat().
| Constante | Description |
|---|---|
| ZIP_EM_NONE | Pas de cryptage. |
| ZIP_EM_AES_128 | Cryptage Winzip AES-128. |
| ZIP_EM_AES_192 | Cryptage Winzip AES-192. |
| ZIP_EM_AES_256 | Cryptage Winzip AES-256. |
| ZIP_EM_TRAD_PKWARE | Chiffrement PKWare traditionnel. N'utilisez pas cette méthode, elle n'est pas sécurisée. Elle est uniquement fournie à des fins de rétrocompatibilité. |
Erreurs
zip_file_set_encryption() échoue si :
| Constante | Description |
|---|---|
| ZIP_ER_ENCRNOTSUPP | Méthode de compression non prise en charge demandée. |
| ZIP_ER_INVAL | index n'est pas un index de fichier valide dans l'archive, ou la combinaison de paramètres n'est pas valide. |
| ZIP_ER_MEMORY | La mémoire requise n'a pas pu être allouée. |
| ZIP_ER_RDONLY | Fichier zip en lecture seulement, aucune modification autorisée. |
Historique
zip_file_set_encryption() a été ajouté dans libzip 1.2.0.
Voir également
libzip(), zip_encryption_method_supported(), zip_fopen_encrypted(), zip_fopen_index_encrypted(), zip_set_default_password(), zip_stat()
Dernière mise à jour : Mercredi, le 5 Février 2025