skip book previous and next navigation links
go up to top of book: HP Open Source Security for OpenVMS Volume 3:... HP Open Source Security for OpenVMS Volume 3:...
go to beginning of chapter: KRB5 (Kerberos V5) Application Programming Interface KRB5 (Kerberos V5) Application Programming Interface
go to previous page: krb5_kt_end_seq_get  Complete a series of sequential key table entry retrievals krb5_kt_end_seq_get Complete a series of sequential key table...
go to next page: krb5_kt_get_name  Get key table namekrb5_kt_get_name Get key table name
end of book navigation links

krb5_kt_get_entry -- Retrieve an entry from the key table 



C Prototype 

krb5_error_code krb5_kt_get_entry(
         krb5_context         context,
         krb5_keytab          id,
         krb5_principal       principal,
         krb5_kvno            vno,
         krb5_keytype         keytype,
         krb5_keytab_entry    *entry );

Arguments 

context
(input/output)
 The context structure.
id (input/output)  A key table handle.
principal (input) A principal name.
vno (input) Key version number. If vno is zero, the first entry whose principal matches is returned.
keytype (input) The key encryption type. Use a keytype of zero if an encryption type does not matter.
entry (output) The returned key table entry.

Description 

This routine searches the keytab identified by id for an entry whose principal matches principal, whose keytype matches keytype, and whose key version number matches vno. It returns an error code if no suitable entry is found. If an entry is found, the entry is returned in *entry; its contents should be deallocated by calling krb5_kt_free_entry when no longer needed.

Return Values 

This routine returns the following KRB5 status code:

0
Successful completion.


go to previous page: krb5_kt_end_seq_get  Complete a series of sequential key table entry retrievals krb5_kt_end_seq_get Complete a series of sequential key table...
go to next page: krb5_kt_get_name  Get key table namekrb5_kt_get_name Get key table name