CreateSelfSignedCertificateA
Zabezpieczenia i podpisy
Opis
Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w CreateSelfSignedCertificate, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode
Tworzy samopodpisany certyfikat RSA z podpisem SHA-256 i eksportuje go wraz z kluczem prywatnym do chronionego hasłem pliku PFX. Wygenerowany plik PFX działa bezpośrednio z SignFile, SetSignProcessPFXFromFile i innymi punktami wejścia podpisywania opartymi na PFX, dlatego przepływy podpisywania można tworzyć i testować bez uzyskiwania certyfikatu od zewnętrznego urzędu.
Certyfikat jest generowany w tymczasowym kontenerze kluczy, który zostaje usunięty po eksporcie; materiał klucza zachowuje tylko plik PFX. Certyfikaty samopodpisane są przeznaczone do testów i dokumentów wewnętrznych: przeglądarki PDF oznaczają je jako niezaufane, chyba że użytkownik jawnie je zainstaluje.
Składnia
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);
Parametry
| SubjectName | Podmiot certyfikatu jako ciąg X.500, na przykład "CN=Alice Signer, O=Example Corp". Sama nazwa bez "=" automatycznie otrzymuje prefiks "CN=" |
|---|---|
| PFXFileName | Ścieżka pliku PFX (PKCS#12), który ma zostać zapisany |
| PFXPassword | Hasło chroniące eksportowany plik PFX |
| ValidDays | Okres ważności w dniach od chwili obecnej; wartości mniejsze niż 1 przyjmują domyślnie 365 |
| KeyBits | Długość klucza RSA w bitach; wartości spoza zakresu 1024..16384 przyjmują domyślnie 2048 |
Wartości zwracane
| 0 | Nie można było utworzyć certyfikatu (pusty podmiot lub nazwa pliku albo błąd Windows CryptoAPI) |
|---|---|
| 1 | Powodzenie |