credential_pwd_get_account_label()

Retrieve account label from credentials.

Synopsis:

#include <sys/credential/credential_pwd.h>
 
int credential_pwd_get_account_label(const credential_t *cred,
                                     char **account_label)

Since:

BlackBerry 10.3.1

Arguments:

cred

Password credentials record.

account_label

On return, a pointer to a string containing account label. The string is UTF-8 encoded and null-terminated. You must call credential_util_free() to release this string 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 retrieves and returns the account label from the password-based credential in a newly allocated buffer.

Returns:

0 if operation was successful, error code otherwise.