krb5_cc_next_cred()--Get Next Entry From a Credentials Cache

 #include <krb5.h>

 krb5_error_code krb5_cc_next_cred(  
     krb5_context     context,  
     krb5_ccache      ccache,
     krb5_cc_cursor *     cursor,  
     krb5_creds *     creds); 

The krb5_cc_next_cred() function reads the next entry from the credentials cache and returns it to the application. The krb5_cc_start_seq_get() routine must be called to begin the sequential read operation. The krb5_cc_next_cred() routine then is called repeatedly to read cache entries. Finally, the krb5_cc_end_seq_get() routine is called when no more entries are to be read.

Authorities

No authorities are required.

Parameters

context  (Input)

The Kerberos context.

ccache  (Input)

The credentials cache handle.

cursor  (Input/Output)

The cursor created by the krb5_cc_start_seq_get() routine. The cursor is updated upon successful completion of this routine.

creds  (Output)

The contents of the cache entry. The krb5_free_cred_contents() routine should be called to release the credentials contents when they are no longer needed.

Return Value

If no errors occur, the return value is 0. Otherwise, a Kerberos error code is returned.

Error Messages

[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]