AddPublicKeyRecipientFromFile
Security and signatures
Description
Adds an X.509 recipient certificate from a DER or PEM file to the selected document before public-key encryption
Syntax
Delphi
Function TPDFlib.AddPublicKeyRecipientFromFile(Const CertificateFileName: WideString; Permissions: Integer): Integer;
ActiveX
Function PDFlib::AddPublicKeyRecipientFromFile(CertificateFileName As String, Permissions As Long) As Long
DLL
int DLAddPublicKeyRecipientFromFile(int InstanceID, const wchar_t* CertificateFileName, int Permissions);
Parameters
| CertificateFileName | Path to an X.509 certificate encoded as DER or PEM |
|---|---|
| Permissions | Permission mask returned by EncodePermissions |
Return values
| 1 | The recipient was added or an identical entry was already present |
|---|---|
| 0 | The certificate, permissions, or document state was invalid |
Remarks
Recipients with the same permissions share one CMS envelope, while different permission masks create separate envelope groups
The DLL also exports DLAddPublicKeyRecipientFromFileA for ANSI paths
See also
AddPublicKeyRecipientFromPFX, AddPublicKeyRecipientFromStore, EncryptPublicKey