MIT Kerberos Documentation

krb5_unparse_name_ext - Convert krb5_principal structure to string and length.

krb5_error_code krb5_unparse_name_ext(krb5_context context, krb5_const_principal principal, char ** name, unsigned int * size)
param:

[in] context - Library context

[in] principal - Principal

[inout] name - String representation of principal name

[inout] size - Size of unparsed name

retval:
  • 0 Success
return:
  • Kerberos error codes. On failure name is set to NULL

This function is similar to krb5_unparse_name() , but allows the use of an existing buffer for the result. If size is not NULL, then *name must be either NULL or an existing buffer of at least size *size. The buffer will be allocated or resized if necessary, with the new pointer stored into *name. Whether or not the buffer is resized, the necessary space for the result, including null terminator, will be stored into *size.

If size is NULL, this function behaves exactly as krb5_unparse_name() .