xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_get_init_creds_opt_alloc.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9) 
1krb5_get_init_creds_opt_alloc -  Allocate a new initial credential options structure.
2======================================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_get_init_creds_opt_alloc(krb5_context context, krb5_get_init_creds_opt ** opt)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[out]** **opt** - New options structure
16
17
18..
19
20
21:retval:
22         -   0   - Success; Kerberos errors otherwise.
23
24
25..
26
27
28
29
30
31
32
33This function is the preferred way to create an options structure for getting initial credentials, and is required to make use of certain options. Use krb5_get_init_creds_opt_free() to free *opt* when it is no longer needed.
34
35
36
37
38
39
40
41
42
43
44..
45
46
47
48
49
50