awGetSSLCertificate

awGetSSLCertificate

BrokerError awGetSSLCertificate(
char *certificate_file,
char *password,
char *trust_file,
BrokerSSLCertificate **certificate);

certificate_file	The name of the certificate file.
password	The certificate file's password.
trust_file	The name of the truststore file.
certificate	The certificate from the certificate file. This parameter is used for output.

Obtains the certificate from the certificate_file.

The caller is responsible for freeing the certificate output value. The BrokerSSLCertificate is allocated as a single block of memory, so nested freeing is unnecessary.

Possible BrokerError major codes	Meaning
AW_ERROR_FILE_NOT_FOUND	The certificate_file could not be found or could not be read.
AW_ERROR_NO_PERMISSION	The password is not valid or the certificate_file does not contain certificates.
AW_ERROR_NULL_PARAM	The certificate_file, password, trust_file, or certificate parameter is NULL.
AW_ERROR_SECURITY	SSL support is not available.