МенеджерКриптографии.НачатьШифрование (CryptoManager.BeginEncrypting)

МенеджерКриптографии (CryptoManager)

НачатьШифрование (BeginEncrypting)

Доступен, начиная с версии 8.3.6.

Вариант синтаксиса: Данные в возвращаемом значении

Синтаксис:

НачатьШифрование(<ОписаниеОповещения>, <ИсходныеДанные>, <Получатели>)

Параметры:

<ОписаниеОповещения> (обязательный)

Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана после завершения шифрования данных со следующими параметрами:

<ПодписанныеДанные> - зашифрованные данные типа ДвоичныеДанные.
<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.

<ИсходныеДанные> (обязательный)

Тип: Строка, ДвоичныеДанные, Поток, ПотокВПамяти, ФайловыйПоток.
Исходные данные для шифрования.
Данные могут размещаться в файле (в этом случае указывается имя файла) или представлены как ДвоичныеДанные, Поток, ПотокВПамяти или ФайловыйПоток.

<Получатели> (обязательный)

Тип: СертификатКриптографии, Массив.
Параметр может содержать один сертификат или массив сертификатов.
Только получатели из указанного списка (получатели, обладающие переданными сертификатами) смогут расшифровать данные, используя свои закрытые ключи.

Описание варианта метода:

Начинает шифрование данных для определенного круга получателей. Только получатели из указанного списка смогут расшифровать данные, используя свои закрытые ключи.
Формат зашифрованных данных - CMS (базируется на PKCS#7).
Используется алгоритм, заданный в свойстве АлгоритмШифрования. После завершения шифрования будет вызвана процедура. имя которой указано в ОписаниеОповещения.
В процедуре, указанной в параметре ОписаниеОповещения, должны присутствовать параметры:

<ЗашифрованныеДанные> - зашифрованные данные типа ДвоичныеДанные.
<ДополнительныеПараметры>.

Вариант синтаксиса: Сохранение данных в файл

Синтаксис:

НачатьШифрование(<ОписаниеОповещения>, <ИсходныеДанные>, <ВыходныеДанные>, <Получатели>)

Параметры:

<ОписаниеОповещения> (обязательный)

<ИмяФайла> - имя файла, в который осуществлен вывод.
<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.

<ИсходныеДанные> (обязательный)

<ВыходныеДанные> (обязательный)

Тип: Строка.
Имя файла, в который будут выгружены зашифрованные данные.

<Получатели> (обязательный)

Тип: СертификатКриптографии, Массив.
Параметр может содержать один сертификат или массив объектов сертификатов.
Только получатели из указанного списка (получатели, обладающие переданными сертификатами) смогут расшифровать данные, используя свои закрытые ключи.

Описание варианта метода:

Зашифрованные данные записываются в файл.

Описание:

Начинает шифрование данных для определенного круга получателей. Только получатели из указанного списка смогут расшифровать данные, используя свои закрытые ключи.
Формат зашифрованных данных - CMS (базируется на PKCS#7).
Размер входных данных для шифрования ограничен 2 Гб (2147483647 байт).
Используется алгоритм, заданный в свойстве АлгоритмШифрования.
После завершения шифрования, будет вызвана процедура. имя которой указано в ОписаниеОповещения.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

См. также:

МенеджерКриптографии, метод Зашифровать
МенеджерКриптографии, метод ЗашифроватьАсинх

Использование в версии:

Доступен, начиная с версии 8.3.6.

Описание изменено в версии 8.3.27.

Методическая информация