NSSLSetClientPKI

Syntax

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

NSSL_RVAL NSSLSetClientPKI(NSSLContextHandle context,
                           NSSLClientCertID clientCertID);

Parameters

context The context for which the client certificate is to be set.
clientCertID An identifier of the built-in client certificate to be used.

Return Values

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

Description

Sets the client certificate and private key (from the built-in certificate store) to be used in case the server performs client certificate verification. The certificate and private key will be used for all the connections created under the context.

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
NSSLAddServerPKI
NSSLAddServerPKIExternal
NSSLAddServerPKIGroups

Revision History

2012/04/06 Initial version.


CONFIDENTIAL