Méthode Workbook.SetPasswordEncryptionOptions (Excel)

  • Article

Définit les options de chiffrement des classeurs à l’aide de mots de passe.

Syntaxe

expression. SetPasswordEncryptionOptions (PasswordEncryptionProvider, PasswordEncryptionAlgorithm, PasswordEncryptionKeyLength, PasswordEncryptionFileProperties)

Expression Variable qui représente un objet Workbook .

Parameters

Nom Requis/Facultatif Type de données Description
PasswordEncryptionProvider Facultatif Variant Chaîne respectant la casse du fournisseur de chiffrement.
PasswordEncryptionAlgorithm Facultatif Variant Chaîne sensible à la casse du nom court algorithmique (autrement dit, « RC4 »).
PasswordEncryptionKeyLength Facultatif Variant Longueur de la clé de chiffrement qui est un multiple de 8 (40 ou plus).
PasswordEncryptionFileProperties Facultatif Variant Affectez à cet argument la valeur True (par défaut) pour chiffrer des propriétés de fichier.

Remarques

Les arguments FournisseurChiffrementMotDePasse, AlgorithmeChiffrementMotDePasse et LongueurCléChiffrementMotDePasse ne sont pas indépendants les uns des autres. Un fournisseur de chiffrement sélectionné limite le jeu d'algorithmes et la longueur de clé qui peuvent être choisis.

Pour l’argument PasswordEncryptionKeyLength , il n’existe aucune limite inhérente à la plage de longueur de clé. La plage est déterminée par le fournisseur de services de chiffrement, qui détermine également l’algorithme de chiffrement.

Exemple

Cet exemple montre comment définir les options de chiffrement du mot de passe pour le classeur actif.

Sub SetPasswordOptions() 
 
 ActiveWorkbook.SetPasswordEncryptionOptions _ 
 PasswordEncryptionProvider:="Microsoft RSA SChannel Cryptographic Provider", _ 
 PasswordEncryptionAlgorithm:="RC4", _ 
 PasswordEncryptionKeyLength:=56, _ 
 PasswordEncryptionFileProperties:=True 
 
End Sub

Remarque

Le code et cette méthode ne font rien pour les nouveaux formats de fichier Excel (xlsx, xlsb, xlsm, etc.), car le classeur utilise toujours le chiffrement AES 128 bits. Si une propriété est définie à l’aide de cette méthode, elle apparaît définie. Lorsque le fichier est rechargé, les propriétés sont réinitialisées au paramètre AES.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.