CertMgr Class

Properties   Methods   Events   Configuration Settings   Errors  

The CertMgr component is used to manage the digital certificates installed on a system.

Class Name

IPWorksOpenPGP_CertMgr

Procedural Interface

 ipworksopenpgp_certmgr_open();
 ipworksopenpgp_certmgr_close($res);
 ipworksopenpgp_certmgr_register_callback($res, $id, $function);
 ipworksopenpgp_certmgr_get_last_error($res);
 ipworksopenpgp_certmgr_get_last_error_code($res);
 ipworksopenpgp_certmgr_set($res, $id, $index, $value);
 ipworksopenpgp_certmgr_get($res, $id, $index);
 ipworksopenpgp_certmgr_do_config($res, $configurationstring);
 ipworksopenpgp_certmgr_do_createcertificate($res, $certsubject, $serialnumber);
 ipworksopenpgp_certmgr_do_createkey($res, $keyname);
 ipworksopenpgp_certmgr_do_deletecertificate($res);
 ipworksopenpgp_certmgr_do_deletekey($res, $keyname);
 ipworksopenpgp_certmgr_do_exportcertificate($res, $pfxfile, $password);
 ipworksopenpgp_certmgr_do_generatecsr($res, $certsubject, $keyname);
 ipworksopenpgp_certmgr_do_importcertificate($res, $pfxfile, $password, $subject);
 ipworksopenpgp_certmgr_do_importsignedcsr($res, $signedcsr, $keyname);
 ipworksopenpgp_certmgr_do_issuecertificate($res, $certsubject, $serialnumber);
 ipworksopenpgp_certmgr_do_listcertificatestores($res);
 ipworksopenpgp_certmgr_do_listkeys($res);
 ipworksopenpgp_certmgr_do_listmachinestores($res);
 ipworksopenpgp_certmgr_do_liststorecertificates($res);
 ipworksopenpgp_certmgr_do_readcertificate($res, $filename);
 ipworksopenpgp_certmgr_do_reset($res);
 ipworksopenpgp_certmgr_do_savecertificate($res, $filename);
 ipworksopenpgp_certmgr_do_showcertificatechain($res);
 ipworksopenpgp_certmgr_do_signcsr($res, $csr, $serialnumber);

Remarks

The class methods, such as ListCertificateStores or ListStoreCertificates, are used to list certificate stores and certificates. The corresponding lists are returned via the StoreList and CertList events. Encoded certificates are provided through the events.

You can load a certificate by setting the Cert property of the class, then you can get information about the certificate through the corresponding fields of the Cert property (described below).

The CertSubject, CertSerialNumber, and CertIssuer properties identify the certificate. The CertEffectiveDate and CertExpirationDate show the time boundaries of the certificate.

CertPublicKey, CertPublicKeyAlgorithm, CertPublicKeyLength, and CertVersion provide information about the certificate keys and the certificate format (version).

CertUsageFlags specifies the intended usage of the certificate. The CertUsage property provides a text description of these flags.