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

krb5_cc_next_cred — Fetch the next credentials entry

 » Table of Contents

 » Glossary

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

C Prototype

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

Arguments

context (input/output) 

The context structure.

id (input/output)  

A credentials cache identifier.

cursor (input/output) 

The cursor created by krb5_cc_start_seq_get. This value is updated upon return to be used in subsequent calls to krb5_cc_next_cred. The returned credentials cache entry.

creds (output) 

The returned credentials cache entry.

Description

This routine fetches the next entry from id, returning its values in *creds, and updates *cursor for the next request. It requires that id identifies a valid credentials cache and *cursor is a cursor returned by krb5_cc_start_seq_get or a subsequent call to krb5_cc_next_cred. The krb5_end_seq_get routine is called when no more entries are to be read.

Return Values

This routine returns the following KRB5 status code:

Error code if there are no more cache entries.



krb5_cc_initialize — Create/refresh a credentials cache
  		 


krb5_cc_remove_cred — Remove credentials from the credentials cache