CreateSelfSignedCertificateA
Segurança e Assinaturas
Descrição
O sufixo A indica o ponto de entrada ANSI (char) da DLL; a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico ao de CreateSelfSignedCertificate e os argumentos de string são interpretados usando a página de código atual definida por SetAnsiMode
Cria um certificado RSA autoassinado com assinatura SHA-256 e o exporta - chave privada incluída - para um arquivo PFX protegido por senha. O PFX gerado funciona diretamente com SignFile, SetSignProcessPFXFromFile e os demais pontos de entrada de assinatura baseados em PFX, de modo que fluxos de assinatura podem ser desenvolvidos e testados sem obter um certificado de uma autoridade externa
O certificado é gerado em um contêiner de chaves temporário que é excluído após a exportação; apenas o arquivo PFX mantém o material da chave. Certificados autoassinados destinam-se a testes e documentos internos: os visualizadores de PDF os marcam como não confiáveis, a menos que o usuário os instale explicitamente
Sintaxe
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);Parâmetros
| SubjectName | O subject do certificado como string X.500, por exemplo "CN=Alice Signer, O=Example Corp". Um nome simples sem "=" recebe o prefixo "CN=" automaticamente. |
|---|---|
| PFXFileName | The path of the PFX (PKCS#12) file to write. |
| PFXPassword | A senha que protege o arquivo PFX exportado. |
| ValidDays | Período de validade em dias a partir de agora; valores abaixo de 1 usam o padrão 365. |
| KeyBits | RSA key length in bits; values outside 1024..16384 default to 2048. |
Valores retornados
| 0 | O certificado não pôde ser criado (subject ou nome de arquivo vazio, ou uma falha da Windows CryptoAPI) |
|---|---|
| 1 | Success |