krb5_kt_next_entry()--Get Next Entry from Key Table

 #include <krb5.h>

 krb5_error_code krb5_kt_next_entry(  
     krb5_context       context,  
     krb5_keytab      ktid,
     krb5_keytab_entry *    entry, 
     krb5_kt_cursor *     cursor);  

The krb5_kt_next_entry() function reads the next entry from the key table and returns it to the application. The krb5_kt_start_seq_get() routine must be called to begin the sequential read operation. The krb5_kt_next_entry() routine then is called repeatedly to read table entries. Finally, the krb5_kt_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.

ktid  (Input)

The key table handle.

entry  (Output)

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

cursor  (Input/Output)

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

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 ]