Discuss this help topic in SecureBlackbox Forum

TElX509CertificateEx.BeginGenerate

TElX509CertificateEx     See also     


Filter: C#/Java  VB.NET  Pascal  C++  PHP  


Starts asynchronous operation of generation of new certificate with defined algorithm and key length.

Declaration

[C#/Java]
    void BeginGenerate(int Algorithm, int DWordsInEncryptKey);
    void BeginGenerate(TElX509Certificate Parent, int Algorithm, int DWordsInEncryptKey);

[VB.NET]
    Sub BeginGenerate(ByVal Algorithm As Integer, ByVal DWordsInEncryptKey As Integer)
    Sub BeginGenerate(ByVal Parent As TElX509Certificate, ByVal Algorithm As Integer, ByVal DWordsInEncryptKey As Integer)

[Pascal]
    procedure BeginGenerate(Algorithm : integer; DwordsInEncryptKey : integer);
    procedure BeginGenerate(Parent : TElX509Certificate; Algorithm: integer; DwordsInEncryptKey: integer);

[C++]
    void BeginGenerate(int32_t Algorithm, int32_t DWordsInEncryptKey);
    void BeginGenerate(TElX509Certificate &Parent, int32_t Algorithm, int32_t DWordsInEncryptKey);
    void BeginGenerate(TElX509Certificate *Parent, int32_t Algorithm, int32_t DWordsInEncryptKey);

[PHP]
    void BeginGenerate(integer $Algorithm, integer $DWordsInEncryptKey)
    void BeginGenerate(TElX509Certificate $Parent, integer $Algorithm, integer $DWordsInEncryptKey)

Parameters

  • Algorithm - specifies the type of the key to be generated. Possible values are listed below.
    When you generate a self-signed certificate, choose one of Signature Algorithms below, otherwise choose one of Public Key Algorithms below.
  • DWordsInEncryptKey - The number of 32-bit words in resulting key. The length of the key in bits is calculated as 32 * DWordsInEncryptKey
  • Parent - certificate to sign newly created one

Values:

The following algorithms may be used as public key algorithms:


The following algorithms may be used as signature algorithms:

Description

    This method causes TElX509CertificateEx object to start asynchronous operation of generation of a new certificate based on specified security algorithm. Specify the length of the resulting key(s) using WordsInEncryptKey parameter. All data of the generated certificate will be accessible via object properties and methods.
    Before calling BeginGenerate you need to set ValidFrom and ValidTo properties.
    BeginGenerate method can be used to generate self-signed certificates or certificates signed by Certificate Authority.
    If you generate certificate signed by Certificate Authority, you need to call SetCACertificate and SetCAPrivateKey methods to specify certificate and private key of the issuer (CA).
    Note, that for self-signed certififcates an instance of TElX509CertificateEx class, whose BeginGenerate method is called, should have a Private Key. If the private key is absent, TElCertificateException is raised.

See also:     AsyncOperationFinished     CancelGeneration     EndGenerate    

Discuss this help topic in SecureBlackbox Forum