NSSLAddServerPKI

Syntax

#include <cafe.h>
#include <cafe/nssl/nsslclient.h>

NSSL_RVAL NSSLAddServerPKI(NSSLContextHandle context,
                           NSSLServerCertID serverCertID);

Parameters

context The context for which the certificate is to be added.
serverCertID Identifier for the CA certificate to be added.

Return Values

NSSL_RVAL_OK on success, error code of type NSSL_RVAL on failure.

Description

Add a trusted CA certificate (from the built-in certificate store) to be used to verify the peer certificate. The certificate is used for all the connections created under the context. NSSLAddServerPKI can be called multiple times for a context to add multiple trusted CA certificates.

NOTE:
Access to the individual built-in certificates is restricted based on capabilities of the application. NSSL_RVAL_CERT_NO_ACCESS is returned if application tries to use a certificate for which it does not have access permission.

Do Not Call From

Callbacks Do not call this function from any callback function.
Interrupt handler Do not call this function from any interrupt handler.
Exception handler Do not call this function from any exception handler.

See Also

NSSLSetClientPKIExternal
NSSLSetClientPKI
NSSLAddServerPKIExternal
NSSLAddServerPKIGroups

Revision History

2012/04/06 Initial version.


CONFIDENTIAL