# MIT Kerberos Documentation

Contents | previous | next | index | Search | feedback

# 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 point to either NULL or an existing buffer of at least the size pointed to by 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()` .