CreateSelfSignedCertificateA
Beveiliging en handtekeningen
Beschrijving
Het achtervoegsel A duidt het ANSI-toegangspunt (char) van de DLL aan; het ActiveX/COM-oppervlak stelt alleen de Unicode-vorm beschikbaar. Het gedrag is identiek aan CreateSelfSignedCertificate en tekenreeksargumenten worden geïnterpreteerd met behulp van de huidige SetAnsiMode-codetabel
Maakt een zelfondertekend RSA-certificaat met een SHA-256-handtekening aan en exporteert het - inclusief private key - naar een met wachtwoord beveiligd PFX-bestand. De gegenereerde PFX werkt direct met SignFile, SetSignProcessPFXFromFile en de andere op PFX gebaseerde ondertekeningseingangspunten, zodat ondertekeningsworkflows kunnen worden ontwikkeld en getest zonder een certificaat bij een externe instantie te hoeven halen
Het certificaat wordt gegenereerd in een tijdelijke sleutelcontainer die na de export weer wordt verwijderd; alleen het PFX-bestand bewaart het sleutelmateriaal. Zelfondertekende certificaten zijn bedoeld voor tests en interne documenten: PDF-viewers markeren ze als niet-vertrouwd tenzij de gebruiker ze expliciet installeert
Syntaxis
Delphi
Function DLCreateSelfSignedCertificateA(InstanceID: Integer; SubjectName, PFXFileName, PFXPassword: PAnsiChar; ValidDays, KeyBits: Integer): Integer;DLL
int DLCreateSelfSignedCertificateA(int InstanceID, const char * SubjectName, const char * PFXFileName, const char * PFXPassword, int ValidDays, int KeyBits);Parameters
| SubjectName | Het certificaatsubject als X.500-string, bijvoorbeeld "CN=Alice Signer, O=Example Corp". Een kale naam zonder "=" krijgt automatisch het prefix "CN=" |
|---|---|
| PFXFileName | Het pad van het weg te schrijven PFX-bestand (PKCS#12) |
| PFXPassword | Het wachtwoord dat het geëxporteerde PFX-bestand beveiligt |
| ValidDays | Geldigheidsduur in dagen vanaf nu; waarden onder 1 krijgen standaard 365 |
| KeyBits | RSA key length in bits; values outside 1024..16384 default to 2048. |
Retourwaarden
| 0 | Het certificaat kon niet worden aangemaakt (leeg subject of bestandsnaam, of een Windows CryptoAPI-fout) |
|---|---|
| 1 | Success |