krb5_unparse_name_flags - Convert krb5_principal structure to a string with flags.

krb5_error_code krb5_unparse_name_flags(krb5_context context, krb5_const_principal principal, int flags, char **name)
param

[in] context - Library context

[in] principal - Principal

[in] flags - Flags

[out] name - String representation of principal name

retval
  • 0 Success

return
  • Kerberos error codes. On failure name is set to NULL

Similar to krb5_unparse_name(), this function converts a krb5_principal structure to a string representation.

The following flags are valid:

  • #KRB5_PRINCIPAL_UNPARSE_SHORT - omit realm if it is the local realm

  • #KRB5_PRINCIPAL_UNPARSE_NO_REALM - omit realm

  • #KRB5_PRINCIPAL_UNPARSE_DISPLAY - do not quote special characters

Use krb5_free_unparsed_name() to free name when it is no longer needed.