1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68
|
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.
|