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

SubjectNamePodmiot 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
PFXPasswordHasło chroniące eksportowany plik PFX
ValidDaysOkres ważności w dniach od chwili obecnej; wartości mniejsze niż 1 przyjmują domyślnie 365
KeyBitsDługość klucza RSA w bitach; wartości spoza zakresu 1024..16384 przyjmują domyślnie 2048

Wartości zwracane

0Nie można było utworzyć certyfikatu (pusty podmiot lub nazwa pliku albo błąd Windows CryptoAPI)
1Powodzenie