IPWorks MQ 2020 C++ Builder Edition

Questions / Feedback?

ImportCertificate Method

Imports a certificate from a file into the current certificate store.

Syntax

void __fastcall ImportCertificate(String CertFile, String Password, String Subject);

Remarks

This method will import a certificate from a file into the current certificate store.

On Windows platforms certificates may only be imported to the Windows certificate store. To load a certificate without importing it to a Windows store set Cert*.

Certificate files with or without a private key may be imported. If the file specified CertFile contains a private key the private key will be imported along with the public certificate. If the file specified by CertFile contains only a public certificate, only the public certificate will be imported.

The Password parameter specifies the certificate password (if any). When importing a public certificate set Password to empty string.

The format of the certificate file being imported must contain valid X509 data to be imported. Not all certificate file formats include X509 data such as PPK or PKCS8 private keys. If the CertFile is of a format that cannot be imported the component raises an exception.

Subject is optional. If empty, the first certificate in the store is loaded instead of the matching certificate.

ImportCertificate Example


//Import a PFX
certmgr.ImportCertificate("..\\test.pfx", "password", "*");
	  
//Import a public certificate (CER)
certmgr.ImportCertificate("..\\test.cer", "", "*");

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks MQ 2020 C++ Builder Edition - Version 20.0 [Build 8155]