krb5_copy_principal - Copy a principal.
=========================================
..
.. c:function:: krb5_error_code krb5_copy_principal(krb5_context context, krb5_const_principal inprinc, krb5_principal * outprinc)
..
:param:
**[in]** **context** - Library context
**[in]** **inprinc** - Principal to be copied
**[out]** **outprinc** - Copy of *inprinc*
..
:retval:
- 0 Success; otherwise - Kerberos error codes
..
This function creates a new principal structure with the contents of *inprinc* . Use :c:func:`krb5_free_principal()` to free *outprinc* when it is no longer needed.
..