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. 

SSLParams has usage pointer.
COBOL does not support tibemsSSLParams_AddTrustedCertFile in release 4.3.

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 16, 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.


TIBCO Enterprise Message Service™ C and COBOL Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com