SetSignProcessExternalDigestSignerFromFile

Security and signatures

Description

Loads a DER-encoded X.509 certificate from a file and configures digest-only signing through the registered external callback

Syntax

Delphi

Function TPDFlib.SetSignProcessExternalDigestSignerFromFile(SignProcessID: Integer; Const CertificateFile: WideString; SignatureAlgorithm, SignatureReserveBytes: Integer): Integer;

ActiveX

Function PDFlib::SetSignProcessExternalDigestSignerFromFile(SignProcessID As Long, CertificateFile As String, SignatureAlgorithm As Long, SignatureReserveBytes As Long) As Long

DLL

int DLSetSignProcessExternalDigestSignerFromFile(int InstanceID, int SignProcessID, const wchar_t* CertificateFile, int SignatureAlgorithm, int SignatureReserveBytes);

Parameters

CertificateFile	Path to a DER-encoded RSA or ECDSA X.509 certificate
SignatureAlgorithm	`1` for RSA PKCS#1 v1.5, `2` for DER ECDSA, or `3` for P1363 ECDSA
SignatureReserveBytes	Expected raw-signature upper bound, or `0` to derive it from the certificate public key

Return values

1	The certificate was read and the external signer was configured
0	The file or configuration was invalid

Remarks

The DLL also exports DLSetSignProcessExternalDigestSignerFromFileA for ANSI paths

The private key remains entirely outside the library process