# MIT Kerberos Documentation

Contents | previous | next | index | Search | feedback

# krb5_kt_read_service_key - Retrieve a service key from a key table.

krb5_error_code krb5_kt_read_service_key(krb5_context context, krb5_pointer keyprocarg, krb5_principal principal, krb5_kvno vno, krb5_enctype enctype, krb5_keyblock **key)

param

  [in] context - Library context

  [in] keyprocarg - Name of a key table (NULL to use default name)

  [in] principal - Service principal

  [in] vno - Key version number (0 for highest available)

  [in] enctype - Encryption type (0 for any type)

  [out] key - Service key from key table

retval

  - 0 Success

return

  - Kerberos error code if not found or keyprocarg is invalid.

Open and search the specified key table for the entry identified by principal , enctype , and vno . If no key is found, return an error code.

The default key table is used, unless keyprocarg is non-null. keyprocarg designates a specific key table.

Use `krb5_free_keyblock()` to free key when it is no longer needed.