credential_set_auth_status_failed()

Report failure of the last authentication attempt using given credentials.

Synopsis:

#include <sys/credential/credential_auth.h>
 
int credential_set_auth_status_failed(credential_t *cred)

Since:

BlackBerry 10.3.1

Arguments:

cred

The credentials used to authenticate.

Library:

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

Description:

The authentication status for given credential is set to CREDENTIAL_AUTH_STATUS_FAILED. The next time these credentials are retrieved, the user will be prompted (provided it is permitted by the prompt policy) to verify the credentials.

Returns:

0 if operation was successful, error code otherwise.