xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_get_renewed_creds.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_get_renewed_creds -  Get renewed credential from KDC using an existing credential.
2========================================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_get_renewed_creds(krb5_context context, krb5_creds * creds, krb5_principal client, krb5_ccache ccache, const char * in_tkt_service)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[out]** **creds** - Renewed credentials
16
17	          **[in]** **client** - Client principal name
18
19	          **[in]** **ccache** - Credential cache
20
21	          **[in]** **in_tkt_service** - Server principal string (or NULL)
22
23
24..
25
26
27:retval:
28         -   0   Success
29
30
31:return:
32         -  Kerberos error codes
33
34..
35
36
37
38
39
40
41
42This function gets a renewed credential using an existing one from *ccache* . If *in_tkt_service* is specified, it is parsed (with the realm part ignored) and used as the server principal of the credential; otherwise, the ticket-granting service is used.
43
44
45
46If successful, the renewed credential is placed in *creds* .
47
48
49
50
51
52
53
54
55
56
57..
58
59
60
61
62
63