Document.SetPasswordEncryptionOptions Метод (2007 System)
Обновлен: Ноябрь 2007
Задает параметры, которые Microsoft Office Word использует для шифрования документов, защищенных паролями.
Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)
Синтаксис
'Декларация
Public Sub SetPasswordEncryptionOptions ( _
PasswordEncryptionProvider As String, _
PasswordEncryptionAlgorithm As String, _
PasswordEncryptionKeyLength As Integer, _
ByRef PasswordEncryptionFileProperties As Object _
)
'Применение
Dim instance As Document
Dim PasswordEncryptionProvider As String
Dim PasswordEncryptionAlgorithm As String
Dim PasswordEncryptionKeyLength As Integer
Dim PasswordEncryptionFileProperties As Object
instance.SetPasswordEncryptionOptions(PasswordEncryptionProvider, _
PasswordEncryptionAlgorithm, PasswordEncryptionKeyLength, _
PasswordEncryptionFileProperties)
public void SetPasswordEncryptionOptions(
string PasswordEncryptionProvider,
string PasswordEncryptionAlgorithm,
int PasswordEncryptionKeyLength,
ref Object PasswordEncryptionFileProperties
)
Параметры
- PasswordEncryptionProvider
Тип: System.String
Имя поставщика шифрования.
- PasswordEncryptionAlgorithm
Тип: System.String
Имя алгоритма шифрования. Word поддерживает алгоритмы поточного шифрования.
- PasswordEncryptionKeyLength
Тип: System.Int32
Длина ключей шифрования. Должна быть кратной 8, минимальная длина — 40.
- PasswordEncryptionFileProperties
Тип: System.Object%
Значение true используется приложением Word для шифрования свойств файла. По умолчанию используется значение true.
Заметки
В целях повышения безопасности не следует использовать алгоритмы Weak Encryption (XOR) (т. н. "OfficeXor") или "Office97/2000 Compatible" (т. н. "OfficeStandard").
Примеры
В приведенном ниже примере кода метод SetPasswordEncryptionOptions используется для применения алгоритма шифрования RC4. В приведенном ниже примере кода задается длина ключа 56, включается шифрование свойств файла, а также задается имя поставщика шифрования для строки "Microsoft RSA SChannel Cryptographic Provider".
В этом примере демонстрируется настройка уровня документа.
Private Sub DocumentSetPasswordEncryptionOptions()
Me.SetPasswordEncryptionOptions( _
"Microsoft RSA SChannel Cryptographic Provider", _
"RC4", 56, True)
End Sub
private void DocumentSetPasswordEncryptionOptions()
{
object PasswordEncryptionFileProperties = true;
this.SetPasswordEncryptionOptions(
"Microsoft RSA SChannel Cryptographic Provider",
"RC4", 56, ref PasswordEncryptionFileProperties);
}
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.