Метод Workbook.SetPasswordEncryptionOptions (Excel)

Статья
04/07/2023

Задает параметры для шифрования книг с помощью паролей.

Синтаксис

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

Выражение Переменная, представляющая объект Workbook .

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
PasswordEncryptionProvider	Необязательный	Variant	Строка поставщика шифрования с учетом регистра.
PasswordEncryptionAlgorithm	Необязательный	Variant	Строка с учетом регистра алгоритмического короткого имени (то есть "RC4").
PasswordEncryptionKeyLength	Необязательный	Variant	Длина ключа шифрования, кратная 8 (40 или больше).
PasswordEncryptionFileProperties	Необязательный	Variant	Значение true (по умолчанию) для шифрования свойств файла.

Замечания

Аргументы PasswordEncryptionProvider, PasswordEncryptionAlgorithm и PasswordEncryptionKeyLength не зависят друг от друга. Выбранный поставщик шифрования ограничивает набор алгоритмов и длину ключа, которые можно выбрать.

Для аргумента PasswordEncryptionKeyLength не существует ограничений на диапазон длины ключа. Диапазон определяется поставщиком служб шифрования, который также определяет алгоритм шифрования.

Пример

В этом примере задаются параметры шифрования паролей для активной книги.

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

Примечание.

Код и этот метод ничего не делают для новых форматов файлов Excel (xlsx, xlsb, xlsm и т. д.), так как книга всегда будет использовать 128-разрядное шифрование AES. Если свойство задано с помощью этого метода, оно отображается как set. При перезагрузке файла свойства сбрасываются в параметр AES.

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.

Поделиться через