NSSLAddServerPKIGroups

Syntax

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

NSSL_RVAL NSSLAddServerPKIGroups(NSSLContextHandle context,
                                 NSSLServerCertGroupMask certGroupMask,
                                 int *addedCount,
                                 int *errorCount);

Parameters

context The context for which the certificates are to be added.
certGroupMask A bitmask with bits for the certificate group to be added to the context.
addedCount A pointer to hold the count of certificates added to the context.
errorCount A pointer to hold the count of certificates which could not be added to the context (due to error).

Return Values

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

Description

Add group(s) of server verification certificate (from the build-in certificate store) for the context. The certificates will be used for all the connections created under the context.

NOTE:
NSSL_RVAL_OK is returned even if error(s) are encountered in adding one or more of the certificates. addedCount and errorCount indicate the number of certificates successfully added and the number of certificates which could not be added due to error.

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
NSSLAddServerPKI

Revision History

2012/04/06 Initial version.


CONFIDENTIAL