CreateSelfSignedCertificateA
Sécurité et signatures
Description
Le suffixe A désigne le point d'entrée ANSI (char) de la DLL ; la surface ActiveX/COM n'expose que la variante Unicode. Le comportement est identique à CreateSelfSignedCertificate et les arguments de chaîne sont interprétés à l'aide de la page de codes SetAnsiMode courante
Crée un certificat RSA autosigné avec une signature SHA-256 et l’exporte, clé privée comprise, dans un fichier PFX protégé par mot de passe. Le PFX fonctionne directement avec SignFile, SetSignProcessPFXFromFile et les autres points d’entrée PFX, permettant de développer et tester les flux sans certificat externe
Le certificat est généré dans un conteneur de clés temporaire supprimé après l’exportation ; seul le fichier PFX conserve le matériel de clé. Les certificats autosignés sont destinés aux tests et documents internes : les visualiseurs les signalent comme non fiables sauf installation explicite par l’utilisateur
Syntaxe
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);
Paramètres
| SubjectName | Sujet du certificat comme chaîne X.500, par exemple "CN=Alice Signer, O=Example Corp". Un nom nu sans "=" reçoit automatiquement le préfixe "CN=" |
|---|---|
| PFXFileName | Chemin du fichier PFX (PKCS#12) à écrire |
| PFXPassword | Mot de passe protégeant le fichier PFX exporté |
| ValidDays | Période de validité en jours à partir de maintenant ; les valeurs inférieures à 1 prennent 365 par défaut |
| KeyBits | Longueur de clé RSA en bits ; les valeurs hors de 1024..16384 prennent 2048 par défaut |
Valeurs de retour
| 0 | Le certificat n'a pas pu être créé (sujet ou nom de fichier vide, ou échec de Windows CryptoAPI) |
|---|---|
| 1 | Success |