xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_unparse_name_ext.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_unparse_name_ext -  Convert krb5_principal structure to string and length.
2================================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_unparse_name_ext(krb5_context context, krb5_const_principal principal, char ** name, unsigned int * size)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[in]** **principal** - Principal
16
17	          **[inout]** **name** - String representation of principal name
18
19	          **[inout]** **size** - Size of unparsed name
20
21
22..
23
24
25:retval:
26         -   0   Success
27
28
29:return:
30         -  Kerberos error codes. On failure name is set to NULL
31
32..
33
34
35
36
37
38
39
40This function is similar to krb5_unparse_name(), but allows the use of an existing buffer for the result. If size is not NULL, then *name* must point to either NULL or an existing buffer of at least the size pointed to by *size* . The buffer will be allocated or resized if necessary, with the new pointer stored into *name* . Whether or not the buffer is resized, the necessary space for the result, including null terminator, will be stored into *size* .
41
42
43
44If size is NULL, this function behaves exactly as krb5_unparse_name().
45
46
47
48
49
50
51
52
53
54
55..
56
57
58
59
60
61