SetSignProcessCNGKeyFromFile
Безопасность и подписи
Описание
Загружает DER-кодированный сертификат X.509 из файла и присоединяет именованный приватный ключ NCrypt к процессу подписания PDF
Синтаксис
Delphi
Function TPDFlib.SetSignProcessCNGKeyFromFile(SignProcessID: Integer; Const CertificateFile, ProviderName, KeyName: WideString; UseMachineKey, AllowUI: Boolean): Integer;
ActiveX
Function PDFlib::SetSignProcessCNGKeyFromFile(SignProcessID As Long, CertificateFile As String, ProviderName As String, KeyName As String, UseMachineKey As Long, AllowUI As Long) As Long
DLL
int DLSetSignProcessCNGKeyFromFile(int InstanceID, int SignProcessID, const wchar_t* CertificateFile, const wchar_t* ProviderName, const wchar_t* KeyName, int UseMachineKey, int AllowUI);
Параметры
| CertificateFile | Path to a DER-encoded RSA or ECDSA X.509 certificate |
|---|---|
| ProviderName | Имя провайдера хранения ключей Windows либо пустая строка для программного провайдера Microsoft |
| KeyName | Постоянное имя ключа, распознаваемое провайдером |
| UseMachineKey | True или ненулевое значение для области ключа машины |
| AllowUI | True или ненулевое значение, чтобы разрешить взаимодействие с провайдером |
Возвращаемые значения
| 1 | Сертификат прочитан, конфигурация присоединена |
|---|---|
| 0 | Недопустимы файл, ID процесса или имя ключа |
Примечания
DLL также экспортирует DLSetSignProcessCNGKeyFromFileA для путей и имен ANSI
Байты сертификата удерживаются процессом подписания, тогда как закрытый ключ остается внутри его провайдера