Copyright © TIBCO Software Inc. All Rights Reserved

> tibemsSSLParams_AddTrustedCert
> Function
> Purpose
> Add one or more trusted certificates to the SSL parameter object.
> C Declaration
> tibems_status tibemsSSLParams_AddTrustedCert(
> tibemsSSLParams SSLParams,
> const void* data,
> tibems_int size,
> tibems_int encoding );
> tibems_status tibemsSSLParams_AddTrustedCertFile(
> tibemsSSLParams SSLParams,
> const char* filename,
> tibems_int encoding );
> COBOL Call
> CALL "tibemsSSLParams_AddTrustedCert"
> USING BY VALUE SSLParams,
> BY REFERENCE data,
> BY VALUE size,
> BY VALUE encoding,
> RETURNING tibems-status
> END-CALL.
> CALL "tibemsSSLParams_AddTrustedCertFile"
> USING BY VALUE SSLParams,
> BY REFERENCE filename,
> BY VALUE encoding,
> RETURNING tibems-status
> END-CALL.

> | SSLParams has usage pointer. COBOL does not support tibemsSSLParams_AddTrustedCertFile in release 6.1.

> Parameters

> Parameter | Description
> SSLParams | Add the certificates to this SSL parameter object.
> data | Use the certificate data at this location.
> size | Length of the certificate data (in bytes).
> encoding | Interpret the certificate data using this encoding; for values, see Table 13, Certificate Encodings.
> filename | Read the certificate data from this file.

> Remarks
> Trusted certificates are certificates that authenticate the server’s certificate; the certificate authority (CA) that issued the server’s certificate supplies these. SSL clients may verify them during the SSL handshake; if your program verifies host certificates (see tibemsSSLParams_SetVerifyHost on page 248), then you must register trusted certificates as well.
> If the parameter object already has trusted certificates, this call adds to that set; it does not overwrite them.

Copyright © TIBCO Software Inc. All Rights Reserved