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

CertificateFileNamePath to an X.509 certificate encoded as DER or PEM
PermissionsPermission mask returned by EncodePermissions

Return values

1The recipient was added or an identical entry was already present
0The 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