HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 6 KRB5 (Kerberos V5) Application Programming Interface

krb5_kt_next_entry — Retrieve the next entry from the key table

 » Table of Contents

 » Glossary

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

C Prototype

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

Arguments

context (input/output) 

The context structure.

id (input/output)  

A key table handle.

entry (output) 

The returned key table entry.

cursor (input/output) 

A cursor to be used in subsequent calls to krb5_kt_next_entry.

Description

This routine fetches the next entry in the keytab, returning it in *entry, and updates *cursor for the next request. If the keytab changes during the sequential get, an error is guaranteed. The argument *entry should be freed after use by calling krb5_kt_free_entry.

This routine requires that id identifies a valid keytab, and *cursor be a cursor returned by krb5_kt_start_seq_get or a subsequent call to krb5_kt_next_entry.

Return Values

This routine returns the following KRB5 status code:

0

Successful completion.



krb5_kt_get_type — Return the keytab prefix
  		 


krb5_kt_read_service_key — Retrieve a service key from the key table