# 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 );

## IBM Systems

These functions are not supported on z/OS and IBM i systems. For more information, see SSL Implementation on IBM EBCDIC Systems.

## 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 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), 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 © Cloud Software Group, Inc. All rights reserved.