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


Метод EnvelopedData.Encrypt

[CAPICOM — это 32-разрядный компонент, доступный для использования в следующих операционных системах: Windows Server 2008, Windows Vista и Windows XP. Вместо этого используйте класс EnvelopedCms в пространстве имен System.Security.Cryptography.Pkcs .]

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

Синтаксис

EnvelopedData.Encrypt( _
  [ ByVal EncodingType ] _
)

Параметры

EncodingType [in, необязательный]

Значение перечисления CAPICOM_ENCODING_TYPE , указывающее тип кодирования, используемый для кодирования конвертированных данных. Значение кодировки по умолчанию — CAPICOM_ENCODE_BASE64. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
CAPICOM_ENCODE_ANY
Этот тип кодирования используется только в том случае, если входные данные имеют неизвестный тип кодирования. Если это значение используется для указания типа кодирования выходных данных, вместо него будет использоваться CAPICOM_ENCODE_BASE64. Представлено в CAPICOM 2.0.
CAPICOM_ENCODE_BASE64
Данные сохраняются в виде строки в кодировке base64.
CAPICOM_ENCODE_BINARY
Данные сохраняются в виде чистой двоичной последовательности.

 

Возвращаемое значение

Этот метод возвращает большой двоичный объект, содержащий конвертированные данные в закодированной строке.

Комментарии

Возвращенный BLOB-объект содержит зашифрованное содержимое и зашифрованный ключ сеанса для каждого предполагаемого получателя. Эти ключи сеанса шифруются с помощью открытого ключа каждого получателя. Зашифрованные ключи сеанса можно расшифровать только с помощью закрытого ключа получателя.

Если свойство Recipients не содержит никаких сведений, этот метод выполняет поиск потенциальных получателей в хранилище сертификатов AddressBook текущего пользователя. Если найдено несколько потенциальных получателей, пользователю предлагается выбрать получателя в диалоговом окне выбора.

Требования

Требование Значение
Окончание поддержки клиентов
Windows Vista
Окончание поддержки сервера
Windows Server 2008
Распространяемые компоненты
CAPICOM 2.0 или более поздней версии в Windows Server 2003 и Windows XP
DLL
Capicom.dll

См. также раздел

Объекты шифрования

EnvelopedData