krb5_cc_next_cred()--Get Next Entry From a Credentials Cache
Syntax
#include <krb5.h> krb5_error_code krb5_cc_next_cred( krb5_context context, krb5_ccache ccache, krb5_cc_cursor * cursor, krb5_creds * creds);Service Program Name: QSYS/QKRBGSS
Default Public Authority: *USE
Threadsafe: Yes
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
Message ID | Error Message Text |
---|---|
CPE3418 E | Possible APAR condition or hardware failure. |
API introduced: V5R1
[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]