Imported Upstream version 1.15.1
[platform/upstream/krb5.git] / doc / html / _sources / appdev / refs / api / krb5_get_fallback_host_realm.txt
1 krb5_get_fallback_host_realm
2 ============================
3
4 ..
5
6 .. c:function:: krb5_error_code krb5_get_fallback_host_realm(krb5_context context, krb5_data * hdata, char *** realmsp)
7
8 ..
9
10
11 :param:
12
13                   **[in]** **context** - Library context
14
15                   **[in]** **hdata** - Host name (or NULL)
16
17                   **[out]** **realmsp** - Null-terminated list of realm names
18
19
20 ..
21
22
23
24 ..
25
26
27
28
29
30
31
32 Fill in *realmsp* with a pointer to a null-terminated list of realm names obtained through heuristics or insecure resolution methods which have lower priority than KDC referrals.
33
34
35
36 If *host* is NULL, the local host's realms are determined.
37
38
39
40 Use :c:func:`krb5_free_host_realm()` to release *realmsp* when it is no longer needed.
41
42
43
44
45
46
47 ..
48
49
50
51
52