SignFile

Sikkerhed og signaturer

Beskrivelse

Anvender en digital signatur på et PDF-dokument på disken.

Signeringsidentiteten skal være i PKCS#12-format og indeholde et certifikat og en privat nøgle

Syntaks

Delphi

Function TPDFlib.SignFile(Const InputFileName, OpenPassword, SignatureFieldName, OutputFileName, PFXFileName, PFXPassword, Reason, Location, ContactInfo: WideString): Integer;

ActiveX

Function PDFlib::SignFile(InputFileName As String, OpenPassword As String, SignatureFieldName As String, OutputFileName As String, PFXFileName As String, PFXPassword As String, Reason As String, Location As String, ContactInfo As String) As Long

DLL

int DLSignFile(int InstanceID, const wchar_t * InputFileName, const wchar_t * OpenPassword, const wchar_t * SignatureFieldName, const wchar_t * OutputFileName, const wchar_t * PFXFileName, const wchar_t * PFXPassword, const wchar_t * Reason, const wchar_t * Location, const wchar_t * ContactInfo);

Parametre

InputFileName	Stien og filnavnet på den input-PDF, der skal signeres
OpenPassword	Den valgfrie adgangskode til at åbne input-PDF-filen, hvis den er krypteret
SignatureFieldName	Navnet på signaturfeltet, der skal signeres. Hvis et felt med dette navn ikke findes, oprettes det. Feltet må ikke være tomt
OutputFileName	Stien til og filnavnet på den signerede PDF, der skal oprettes. Det skal være en anden fil end InputFileName. Hvis der kræves signering på stedet (overskrivning af originalfilen), skal parameteren være tom
PFXFileName	Stien og navnet på PKCS#12-filen med certifikat/privat nøgle (.pfx-fil). Adgangskoden til åbning af PFX-filen.
PFXPassword	En valgfri streng, der angiver årsagen til signeringen.
Reason
Location	En valgfri streng, der angiver det sted, hvor signeringen blev udført.
ContactInfo	En valgfri streng, der angiver underskriverens kontaktoplysninger

Returværdier

1	Filen blev signeret 2 Input-PDF blev ikke fundet 3 Input-PDF kan ikke læses Adgangskoden til input-PDF er forkert 4 5 Certifikatfilen blev ikke fundet 6 Certifikatfilen er ugyldig 7 Forkert certifikatadgangskode 8 Ukendt certifikatformat Der blev ikke fundet nogen privat nøgle i certifikatfilen 9 10 Outputfilen kunne ikke skrives 11 Signaturen kunne ikke anvendes Signaturfeltnavnet var tomt 12