credential_from_handle_string()

Create an credential from its encoded handle representation.

Synopsis:

#include <sys/credential/credential_store.h>

int credential_from_handle_string(const char *handle_str,
                                  credential_t **cred)

Since:

BlackBerry 10.3.1

Arguments:

handle_str: ASCII encoded string that contains the encoded credential handle.

cred: Credential that corresponds to the given handle. You must call credential_release() to release this structure when you're done using it.

Library:

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

Description:

This function allocates a new credential_t structure and initializes it to represent the same credential as the handle string.

This is a convenience function that decodes the credential handle from a string created by credential_to_handle_string()

Returns:

0 if operation was successful, error code otherwise.