xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_build_principal_alloc_va.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_build_principal_alloc_va -  Build a principal name, using a precomputed variable argument list.
2=====================================================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_build_principal_alloc_va(krb5_context context, krb5_principal * princ, unsigned int rlen, const char * realm, va_list ap)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[out]** **princ** - Principal structure
16
17	          **[in]** **rlen** - Realm name length
18
19	          **[in]** **realm** - Realm name
20
21	          **[in]** **ap** - List of char * components, ending with NULL
22
23
24..
25
26
27:retval:
28         -   0   Success
29
30
31:return:
32         -  Kerberos error codes
33
34..
35
36
37
38
39
40
41
42Similar to krb5_build_principal(), this function builds a principal name, but its name components are specified as a va_list.
43
44
45
46Use krb5_free_principal() to deallocate *princ* when it is no longer needed.
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61..
62
63
64
65
66
67