credential_cert_get_handle()

Retrieve the certificate handle from credentials.

Synopsis:

#include <sys/credential/credential_cert.h>
 
int credential_cert_get_handle(const credential_t *cert,
                                             char **handle)

Since:

BlackBerry 10.3.1

Arguments:

cert

Certificate credentials record.

handle

On return, a pointer to a string containing the certificate handle. The string is UTF-8 encoded and null-terminated. You must call credential_util_free() to release this string when you are finished using it.

Library:

libcredential (For the qcc command, use the -l bps option to link against this library)

Description:

Retrieve and return the certificate handle in a newly allocated buffer. You can use the certificate handle to configure a client certificate in the OpenSSL engine.

Returns:

0 if operation was successful, error code otherwise.