credential_iterator_next()

#include <sys/credential/credential_store.h>
 

int credential_iterator_next(credential_iterator_t *iter,
                             credential_t **cred)

Since:

BlackBerry 10.3.1

Arguments:

iter

Credential iteration.

cred

On return, a pointer to the next credential in iteration. If no more credentials are available, then this pointer will be set to 0. The memory for the returned credential is owned by the credential iterator. If you need a private copy of the credential, call credential_clone() to create a copy.

Library:

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

Description:

This function queries the credential iterator and returns the next available credential. The returned credential is owned by the credential iterator and its memory will be released when the credential iterator is released.

Returns:

0 if operation was successful, error code otherwise.