14b2fc10137e24068e26ee1fb2d30a99350cb6fb
[platform/upstream/krb5.git] / doc / html / _sources / appdev / refs / api / krb5_524_conv_principal.txt
1 krb5_524_conv_principal -  Convert a Kerberos V5 principal to a Kerberos V4 principal. 
2 =======================================================================================
3
4 ..
5
6 .. c:function:: krb5_error_code krb5_524_conv_principal(krb5_context context, krb5_const_principal princ, char * name, char * inst, char * realm)
7
8 ..
9
10
11 :param:
12
13                   **[in]** **context** - Library context
14
15                   **[in]** **princ** - V5 Principal
16
17                   **[out]** **name** - V4 principal's name to be filled in
18
19                   **[out]** **inst** - V4 principal's instance name to be filled in
20
21                   **[out]** **realm** - Principal's realm name to be filled in
22
23
24 ..
25
26
27 :retval:
28          -   0   Success
29          -   KRB5_INVALID_PRINCIPAL   Invalid principal name
30          -   KRB5_CONFIG_CANTOPEN   Can't open or find Kerberos configuration file
31
32
33 :return:
34          -  Kerberos error codes 
35
36 ..
37
38
39
40
41
42
43
44 This function separates a V5 principal *princ* into *name* , *instance* , and *realm* .
45
46
47
48
49
50
51
52
53
54
55 ..
56
57
58
59
60