Imported Upstream version 1.15.2
[platform/upstream/krb5.git] / doc / html / _sources / appdev / refs / api / krb5_unparse_name.txt
1 krb5_unparse_name -  Convert a krb5_principal structure to a string representation. 
2 ====================================================================================
3
4 ..
5
6 .. c:function:: krb5_error_code krb5_unparse_name(krb5_context context, krb5_const_principal principal, register char ** name)
7
8 ..
9
10
11 :param:
12
13                   **[in]** **context** - Library context
14
15                   **[in]** **principal** - Principal
16
17                   **[out]** **name** - String representation of principal name
18
19
20 ..
21
22
23 :retval:
24          -   0   Success
25
26
27 :return:
28          -  Kerberos error codes 
29
30 ..
31
32
33
34
35
36
37
38 The resulting string representation uses the format and quoting conventions described for :c:func:`krb5_parse_name()` .
39
40
41
42 Use :c:func:`krb5_free_unparsed_name()` to free *name* when it is no longer needed.
43
44
45
46
47
48
49
50
51
52
53 ..
54
55
56
57
58