krb5_build_principal -  Build a principal name using null-terminated strings. 
==============================================================================

..

.. c:function:: krb5_error_code krb5_build_principal(krb5_context context, krb5_principal * princ, unsigned int rlen, const char * realm, ... )

..


:param:

	          **[in]** **context** - Library context

	          **[out]** **princ** - Principal name

	          **[in]** **rlen** - Realm name length

	          **[in]** **realm** - Realm name


..


:retval:
         -   0   Success


:return:
         -  Kerberos error codes 

..







Call :c:func:`krb5_free_principal()` to free *princ* when it is no longer needed.














..






.. note::

	 :c:func:`krb5_build_principal()` and :c:func:`krb5_build_principal_alloc_va()` perform the same task. :c:func:`krb5_build_principal()` takes variadic arguments. :c:func:`krb5_build_principal_alloc_va()` takes a pre-computed *varargs* pointer.